001    /* -*- Mode: java; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 4 -*-
002     *
003     * The contents of this file are subject to the Netscape Public
004     * License Version 1.1 (the "License"); you may not use this file
005     * except in compliance with the License. You may obtain a copy of
006     * the License at http://www.mozilla.org/NPL/
007     *
008     * Software distributed under the License is distributed on an "AS
009     * IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
010     * implied. See the License for the specific language governing
011     * rights and limitations under the License.
012     *
013     * The Original Code is Rhino code, released
014     * May 6, 1999.
015     *
016     * The Initial Developer of the Original Code is Netscape
017     * Communications Corporation.  Portions created by Netscape are
018     * Copyright (C) 1997-1999 Netscape Communications Corporation. All
019     * Rights Reserved.
020     *
021     * Contributor(s):
022     * Norris Boyd
023     *
024     * Alternatively, the contents of this file may be used under the
025     * terms of the GNU Public License (the "GPL"), in which case the
026     * provisions of the GPL are applicable instead of those above.
027     * If you wish to allow use of your version of this file only
028     * under the terms of the GPL and not to allow others to use your
029     * version of this file under the NPL, indicate your decision by
030     * deleting the provisions above and replace them with the notice
031     * and other provisions required by the GPL.  If you do not delete
032     * the provisions above, a recipient may use your version of this
033     * file under either the NPL or the GPL.
034     */
035    // Modified by Google
036    
037    // API class
038    
039    package com.google.gwt.dev.js.rhino;
040    
041    import org.jetbrains.annotations.NotNull;
042    
043    /**
044     * This is interface defines a protocol for the reporting of
045     * errors during JavaScript translation or execution.
046     */
047    
048    public interface ErrorReporter {
049    
050        /**
051         * Report a warning.
052         *
053         * The implementing class may choose to ignore the warning
054         * if it desires.
055         *
056         * @param message a String describing the error
057         * @param startPosition position before error token
058         * @param endPosition position after error token
059         */
060        void warning(@NotNull String message, @NotNull CodePosition startPosition, @NotNull CodePosition endPosition);
061    
062        /**
063         * Report an error.
064         *
065         * The implementing class is free to throw an exception if
066         * it desires.
067         *
068         * If execution has not yet begun, the JavaScript engine is
069         * free to find additional errors rather than terminating
070         * the translation. It will not execute a script that had
071         * errors, however.
072         *
073         * @param message a String describing the error
074         * @param startPosition position before error token
075         * @param endPosition position after error token
076         */
077        void error(@NotNull String message, @NotNull CodePosition startPosition, @NotNull CodePosition endPosition);
078    }