org.mozilla.javascript
Interface ErrorReporter

public interface ErrorReporter

This is interface defines a protocol for the reporting of errors during JavaScript translation or execution.

Author:

Norris Boyd

Method Summary

void	error(java.lang.String message, java.lang.String sourceName, int line, java.lang.String lineSource, int lineOffset) Report an error.
EvaluatorException	runtimeError(java.lang.String message, java.lang.String sourceName, int line, java.lang.String lineSource, int lineOffset) Creates an EvaluatorException that may be thrown.
void	warning(java.lang.String message, java.lang.String sourceName, int line, java.lang.String lineSource, int lineOffset) Report a warning.

Method Detail

warning

void warning(java.lang.String message,
             java.lang.String sourceName,
             int line,
             java.lang.String lineSource,
             int lineOffset)

Report a warning. The implementing class may choose to ignore the warning if it desires.

Parameters:

message - a String describing the warning

sourceName - a String describing the JavaScript source where the warning occured; typically a filename or URL

line - the line number associated with the warning

lineSource - the text of the line (may be null)

lineOffset - the offset into lineSource where problem was detected

error

void error(java.lang.String message,
           java.lang.String sourceName,
           int line,
           java.lang.String lineSource,
           int lineOffset)

Report an error. The implementing class is free to throw an exception if it desires. If execution has not yet begun, the JavaScript engine is free to find additional errors rather than terminating the translation. It will not execute a script that had errors, however.

Parameters:

message - a String describing the error

sourceName - a String describing the JavaScript source where the error occured; typically a filename or URL

line - the line number associated with the error

lineSource - the text of the line (may be null)

lineOffset - the offset into lineSource where problem was detected

runtimeError

EvaluatorException runtimeError(java.lang.String message,
                                java.lang.String sourceName,
                                int line,
                                java.lang.String lineSource,
                                int lineOffset)

Creates an EvaluatorException that may be thrown. runtimeErrors, unlike errors, will always terminate the current script.

Parameters:

message - a String describing the error

sourceName - a String describing the JavaScript source where the error occured; typically a filename or URL

line - the line number associated with the error

lineSource - the text of the line (may be null)

lineOffset - the offset into lineSource where problem was detected

Returns:

an EvaluatorException that will be thrown.