| 1 | /*
|
|---|
| 2 | * Copyright (C) 1999-2001 Harri Porten ([email protected])
|
|---|
| 3 | * Copyright (C) 2001 Peter Kelly ([email protected])
|
|---|
| 4 | * Copyright (C) 2003, 2007 Apple Inc. All rights reserved.
|
|---|
| 5 | *
|
|---|
| 6 | * This library is free software; you can redistribute it and/or
|
|---|
| 7 | * modify it under the terms of the GNU Library General Public
|
|---|
| 8 | * License as published by the Free Software Foundation; either
|
|---|
| 9 | * version 2 of the License, or (at your option) any later version.
|
|---|
| 10 | *
|
|---|
| 11 | * This library is distributed in the hope that it will be useful,
|
|---|
| 12 | * but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|---|
| 13 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|---|
| 14 | * Library General Public License for more details.
|
|---|
| 15 | *
|
|---|
| 16 | * You should have received a copy of the GNU Library General Public License
|
|---|
| 17 | * along with this library; see the file COPYING.LIB. If not, write to
|
|---|
| 18 | * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
|
|---|
| 19 | * Boston, MA 02110-1301, USA.
|
|---|
| 20 | *
|
|---|
| 21 | */
|
|---|
| 22 |
|
|---|
| 23 | #ifndef KJS_Interpreter_h
|
|---|
| 24 | #define KJS_Interpreter_h
|
|---|
| 25 |
|
|---|
| 26 | #include <wtf/PassRefPtr.h>
|
|---|
| 27 | #include <wtf/unicode/Unicode.h>
|
|---|
| 28 |
|
|---|
| 29 | namespace KJS {
|
|---|
| 30 |
|
|---|
| 31 | class Completion;
|
|---|
| 32 | class ExecState;
|
|---|
| 33 | class JSValue;
|
|---|
| 34 | class ScopeChain;
|
|---|
| 35 | class SourceProvider;
|
|---|
| 36 | class UString;
|
|---|
| 37 |
|
|---|
| 38 | class Interpreter {
|
|---|
| 39 | public:
|
|---|
| 40 | /**
|
|---|
| 41 | * Parses the supplied ECMAScript code and checks for syntax errors.
|
|---|
| 42 | *
|
|---|
| 43 | * @param code The code to check
|
|---|
| 44 | * @return A normal completion if there were no syntax errors in the code,
|
|---|
| 45 | * otherwise a throw completion with the syntax error as its value.
|
|---|
| 46 | */
|
|---|
| 47 | static Completion checkSyntax(ExecState*, const UString& sourceURL, int startingLineNumber, const UString& code);
|
|---|
| 48 | static Completion checkSyntax(ExecState*, const UString& sourceURL, int startingLineNumber, PassRefPtr<SourceProvider> source);
|
|---|
| 49 |
|
|---|
| 50 | /**
|
|---|
| 51 | * Evaluates the supplied ECMAScript code.
|
|---|
| 52 | *
|
|---|
| 53 | * Since this method returns a Completion, you should check the type of
|
|---|
| 54 | * completion to detect an error or before attempting to access the returned
|
|---|
| 55 | * value. For example, if an error occurs during script execution and is not
|
|---|
| 56 | * caught by the script, the completion type will be Throw.
|
|---|
| 57 | *
|
|---|
| 58 | * If the supplied code is invalid, a SyntaxError will be thrown.
|
|---|
| 59 | *
|
|---|
| 60 | * @param code The code to evaluate
|
|---|
| 61 | * @param thisV The value to pass in as the "this" value for the script
|
|---|
| 62 | * execution. This should either be jsNull() or an Object.
|
|---|
| 63 | * @return A completion object representing the result of the execution.
|
|---|
| 64 | */
|
|---|
| 65 | static Completion evaluate(ExecState*, ScopeChain&, const UString& sourceURL, int startingLineNumber, const UString& code, JSValue* thisV = 0);
|
|---|
| 66 | static Completion evaluate(ExecState*, ScopeChain&, const UString& sourceURL, int startingLineNumber, PassRefPtr<SourceProvider>, JSValue* thisV = 0);
|
|---|
| 67 |
|
|---|
| 68 | static bool shouldPrintExceptions();
|
|---|
| 69 | static void setShouldPrintExceptions(bool);
|
|---|
| 70 | };
|
|---|
| 71 |
|
|---|
| 72 | } // namespace KJS
|
|---|
| 73 |
|
|---|
| 74 | #endif // KJS_Interpreter_h
|
|---|
