2020-03-11 18:27:43 +00:00
|
|
|
/*
|
|
|
|
* Copyright (c) 2020, Stephan Unverwerth <s.unverwerth@gmx.de>
|
|
|
|
* All rights reserved.
|
|
|
|
*
|
|
|
|
* Redistribution and use in source and binary forms, with or without
|
|
|
|
* modification, are permitted provided that the following conditions are met:
|
|
|
|
*
|
|
|
|
* 1. Redistributions of source code must retain the above copyright notice, this
|
|
|
|
* list of conditions and the following disclaimer.
|
|
|
|
*
|
|
|
|
* 2. Redistributions in binary form must reproduce the above copyright notice,
|
|
|
|
* this list of conditions and the following disclaimer in the documentation
|
|
|
|
* and/or other materials provided with the distribution.
|
|
|
|
*
|
|
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
|
|
|
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
|
|
* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
|
|
|
|
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
|
|
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
|
|
|
* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
|
|
|
|
* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
|
|
|
|
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
|
|
|
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#pragma once
|
|
|
|
|
2020-10-08 17:49:08 +00:00
|
|
|
#include <AK/HashTable.h>
|
2020-03-18 10:23:53 +00:00
|
|
|
#include <AK/NonnullRefPtr.h>
|
2020-05-26 11:57:50 +00:00
|
|
|
#include <AK/StringBuilder.h>
|
2020-05-28 05:22:08 +00:00
|
|
|
#include <LibJS/AST.h>
|
|
|
|
#include <LibJS/Lexer.h>
|
2020-05-14 15:26:01 +00:00
|
|
|
#include <stdio.h>
|
2020-03-11 18:27:43 +00:00
|
|
|
|
|
|
|
namespace JS {
|
2020-03-12 22:02:41 +00:00
|
|
|
|
|
|
|
enum class Associativity {
|
|
|
|
Left,
|
|
|
|
Right
|
|
|
|
};
|
|
|
|
|
2020-10-20 16:56:49 +00:00
|
|
|
struct FunctionNodeParseOptions {
|
|
|
|
enum {
|
|
|
|
CheckForFunctionAndName = 1 << 0,
|
|
|
|
AllowSuperPropertyLookup = 1 << 1,
|
|
|
|
AllowSuperConstructorCall = 1 << 2,
|
2020-10-20 17:32:51 +00:00
|
|
|
IsGetterFunction = 1 << 3,
|
|
|
|
IsSetterFunction = 1 << 4,
|
2020-10-20 16:56:49 +00:00
|
|
|
};
|
|
|
|
};
|
|
|
|
|
2020-03-11 18:27:43 +00:00
|
|
|
class Parser {
|
|
|
|
public:
|
|
|
|
explicit Parser(Lexer lexer);
|
|
|
|
|
2020-03-18 10:23:53 +00:00
|
|
|
NonnullRefPtr<Program> parse_program();
|
2020-03-11 18:27:43 +00:00
|
|
|
|
2020-03-19 10:52:56 +00:00
|
|
|
template<typename FunctionNodeType>
|
2020-10-20 16:56:49 +00:00
|
|
|
NonnullRefPtr<FunctionNodeType> parse_function_node(u8 parse_options = FunctionNodeParseOptions::CheckForFunctionAndName);
|
2020-10-20 17:32:51 +00:00
|
|
|
Vector<FunctionNode::Parameter> parse_function_parameters(int& function_length, u8 parse_options = 0);
|
2020-03-19 10:52:56 +00:00
|
|
|
|
2020-10-22 22:30:07 +00:00
|
|
|
NonnullRefPtr<Declaration> parse_declaration();
|
2020-03-18 10:23:53 +00:00
|
|
|
NonnullRefPtr<Statement> parse_statement();
|
|
|
|
NonnullRefPtr<BlockStatement> parse_block_statement();
|
2020-10-04 00:02:43 +00:00
|
|
|
NonnullRefPtr<BlockStatement> parse_block_statement(bool& is_strict);
|
2020-03-18 10:23:53 +00:00
|
|
|
NonnullRefPtr<ReturnStatement> parse_return_statement();
|
2020-04-21 18:21:26 +00:00
|
|
|
NonnullRefPtr<VariableDeclaration> parse_variable_declaration(bool with_semicolon = true);
|
|
|
|
NonnullRefPtr<Statement> parse_for_statement();
|
|
|
|
NonnullRefPtr<Statement> parse_for_in_of_statement(NonnullRefPtr<ASTNode> lhs);
|
2020-03-21 17:40:17 +00:00
|
|
|
NonnullRefPtr<IfStatement> parse_if_statement();
|
2020-03-24 21:03:50 +00:00
|
|
|
NonnullRefPtr<ThrowStatement> parse_throw_statement();
|
2020-03-24 13:03:55 +00:00
|
|
|
NonnullRefPtr<TryStatement> parse_try_statement();
|
|
|
|
NonnullRefPtr<CatchClause> parse_catch_clause();
|
2020-03-29 11:09:54 +00:00
|
|
|
NonnullRefPtr<SwitchStatement> parse_switch_statement();
|
|
|
|
NonnullRefPtr<SwitchCase> parse_switch_case();
|
|
|
|
NonnullRefPtr<BreakStatement> parse_break_statement();
|
2020-04-04 22:22:42 +00:00
|
|
|
NonnullRefPtr<ContinueStatement> parse_continue_statement();
|
2020-04-04 19:29:23 +00:00
|
|
|
NonnullRefPtr<DoWhileStatement> parse_do_while_statement();
|
2020-04-21 18:27:57 +00:00
|
|
|
NonnullRefPtr<WhileStatement> parse_while_statement();
|
2020-04-30 16:26:27 +00:00
|
|
|
NonnullRefPtr<DebuggerStatement> parse_debugger_statement();
|
2020-04-03 10:14:28 +00:00
|
|
|
NonnullRefPtr<ConditionalExpression> parse_conditional_expression(NonnullRefPtr<Expression> test);
|
2020-03-11 18:27:43 +00:00
|
|
|
|
2020-04-21 18:21:26 +00:00
|
|
|
NonnullRefPtr<Expression> parse_expression(int min_precedence, Associativity associate = Associativity::Right, Vector<TokenType> forbidden = {});
|
2020-03-18 10:23:53 +00:00
|
|
|
NonnullRefPtr<Expression> parse_primary_expression();
|
|
|
|
NonnullRefPtr<Expression> parse_unary_prefixed_expression();
|
2020-06-03 23:05:49 +00:00
|
|
|
NonnullRefPtr<RegExpLiteral> parse_regexp_literal();
|
2020-03-18 10:23:53 +00:00
|
|
|
NonnullRefPtr<ObjectExpression> parse_object_expression();
|
2020-03-20 19:29:57 +00:00
|
|
|
NonnullRefPtr<ArrayExpression> parse_array_expression();
|
2020-05-17 06:27:25 +00:00
|
|
|
NonnullRefPtr<StringLiteral> parse_string_literal(Token token);
|
2020-05-06 23:34:14 +00:00
|
|
|
NonnullRefPtr<TemplateLiteral> parse_template_literal(bool is_tagged);
|
2020-03-18 10:23:53 +00:00
|
|
|
NonnullRefPtr<Expression> parse_secondary_expression(NonnullRefPtr<Expression>, int min_precedence, Associativity associate = Associativity::Right);
|
|
|
|
NonnullRefPtr<CallExpression> parse_call_expression(NonnullRefPtr<Expression>);
|
2020-03-28 15:33:52 +00:00
|
|
|
NonnullRefPtr<NewExpression> parse_new_expression();
|
2020-03-30 13:26:09 +00:00
|
|
|
RefPtr<FunctionExpression> try_parse_arrow_function_expression(bool expect_parens);
|
2020-05-28 18:09:19 +00:00
|
|
|
RefPtr<Statement> try_parse_labelled_statement();
|
2020-06-08 18:31:21 +00:00
|
|
|
NonnullRefPtr<ClassDeclaration> parse_class_declaration();
|
|
|
|
NonnullRefPtr<ClassExpression> parse_class_expression(bool expect_class_name);
|
|
|
|
NonnullRefPtr<Expression> parse_property_key();
|
2020-10-04 22:58:57 +00:00
|
|
|
NonnullRefPtr<AssignmentExpression> parse_assignment_expression(AssignmentOp, NonnullRefPtr<Expression> lhs, int min_precedence, Associativity);
|
2020-03-11 18:27:43 +00:00
|
|
|
|
2020-05-14 15:26:01 +00:00
|
|
|
struct Error {
|
|
|
|
String message;
|
|
|
|
size_t line;
|
|
|
|
size_t column;
|
|
|
|
|
|
|
|
String to_string() const
|
|
|
|
{
|
|
|
|
if (line == 0 || column == 0)
|
|
|
|
return message;
|
2020-10-04 13:53:15 +00:00
|
|
|
return String::formatted("{} (line: {}, column: {})", message, line, column);
|
2020-05-14 15:26:01 +00:00
|
|
|
}
|
2020-05-26 11:57:50 +00:00
|
|
|
|
|
|
|
String source_location_hint(const StringView& source, const char spacer = ' ', const char indicator = '^') const
|
|
|
|
{
|
|
|
|
if (line == 0 || column == 0)
|
|
|
|
return {};
|
2020-10-21 21:16:45 +00:00
|
|
|
// We need to modify the source to match what the lexer considers one line - normalizing
|
|
|
|
// line terminators to \n is easier than splitting using all different LT characters.
|
|
|
|
String source_string { source };
|
|
|
|
source_string.replace("\r\n", "\n");
|
|
|
|
source_string.replace("\r", "\n");
|
|
|
|
source_string.replace(LINE_SEPARATOR, "\n");
|
|
|
|
source_string.replace(PARAGRAPH_SEPARATOR, "\n");
|
2020-05-26 11:57:50 +00:00
|
|
|
StringBuilder builder;
|
2020-10-21 21:16:45 +00:00
|
|
|
builder.append(source_string.split_view('\n', true)[line - 1]);
|
2020-05-26 11:57:50 +00:00
|
|
|
builder.append('\n');
|
|
|
|
for (size_t i = 0; i < column - 1; ++i)
|
|
|
|
builder.append(spacer);
|
|
|
|
builder.append(indicator);
|
|
|
|
return builder.build();
|
|
|
|
}
|
2020-05-14 15:26:01 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
bool has_errors() const { return m_parser_state.m_errors.size(); }
|
|
|
|
const Vector<Error>& errors() const { return m_parser_state.m_errors; }
|
|
|
|
void print_errors() const
|
|
|
|
{
|
|
|
|
for (auto& error : m_parser_state.m_errors)
|
|
|
|
fprintf(stderr, "SyntaxError: %s\n", error.to_string().characters());
|
|
|
|
}
|
2020-03-11 18:27:43 +00:00
|
|
|
|
|
|
|
private:
|
2020-04-13 14:42:54 +00:00
|
|
|
friend class ScopePusher;
|
|
|
|
|
2020-03-12 22:02:41 +00:00
|
|
|
Associativity operator_associativity(TokenType) const;
|
2020-03-11 18:27:43 +00:00
|
|
|
bool match_expression() const;
|
2020-03-14 18:45:51 +00:00
|
|
|
bool match_unary_prefixed_expression() const;
|
2020-04-21 18:21:26 +00:00
|
|
|
bool match_secondary_expression(Vector<TokenType> forbidden = {}) const;
|
2020-03-11 18:27:43 +00:00
|
|
|
bool match_statement() const;
|
2020-10-22 22:30:07 +00:00
|
|
|
bool match_declaration() const;
|
2020-03-23 18:08:32 +00:00
|
|
|
bool match_variable_declaration() const;
|
2020-04-18 18:31:27 +00:00
|
|
|
bool match_identifier_name() const;
|
2020-06-08 18:31:21 +00:00
|
|
|
bool match_property_key() const;
|
2020-03-11 18:27:43 +00:00
|
|
|
bool match(TokenType type) const;
|
|
|
|
bool done() const;
|
|
|
|
void expected(const char* what);
|
2020-04-29 20:37:51 +00:00
|
|
|
void syntax_error(const String& message, size_t line = 0, size_t column = 0);
|
2020-03-11 18:27:43 +00:00
|
|
|
Token consume();
|
|
|
|
Token consume(TokenType type);
|
2020-10-19 17:01:28 +00:00
|
|
|
Token consume_and_validate_numeric_literal();
|
2020-04-17 13:05:58 +00:00
|
|
|
void consume_or_insert_semicolon();
|
2020-03-30 13:24:43 +00:00
|
|
|
void save_state();
|
|
|
|
void load_state();
|
2020-03-11 18:27:43 +00:00
|
|
|
|
2020-05-28 05:22:08 +00:00
|
|
|
enum class UseStrictDirectiveState {
|
|
|
|
None,
|
|
|
|
Looking,
|
|
|
|
Found,
|
|
|
|
};
|
|
|
|
|
2020-03-30 13:24:43 +00:00
|
|
|
struct ParserState {
|
|
|
|
Lexer m_lexer;
|
|
|
|
Token m_current_token;
|
2020-05-14 15:26:01 +00:00
|
|
|
Vector<Error> m_errors;
|
2020-04-13 14:42:54 +00:00
|
|
|
Vector<NonnullRefPtrVector<VariableDeclaration>> m_var_scopes;
|
|
|
|
Vector<NonnullRefPtrVector<VariableDeclaration>> m_let_scopes;
|
2020-06-04 12:48:36 +00:00
|
|
|
Vector<NonnullRefPtrVector<FunctionDeclaration>> m_function_scopes;
|
2020-05-28 05:22:08 +00:00
|
|
|
UseStrictDirectiveState m_use_strict_directive { UseStrictDirectiveState::None };
|
2020-10-08 17:49:08 +00:00
|
|
|
HashTable<StringView> m_labels_in_scope;
|
2020-05-28 05:22:08 +00:00
|
|
|
bool m_strict_mode { false };
|
2020-06-08 18:31:21 +00:00
|
|
|
bool m_allow_super_property_lookup { false };
|
|
|
|
bool m_allow_super_constructor_call { false };
|
2020-10-07 18:33:48 +00:00
|
|
|
bool m_in_function_context { false };
|
2020-10-07 19:21:15 +00:00
|
|
|
bool m_in_break_context { false };
|
|
|
|
bool m_in_continue_context { false };
|
2020-03-30 13:24:43 +00:00
|
|
|
|
|
|
|
explicit ParserState(Lexer);
|
|
|
|
};
|
|
|
|
|
|
|
|
ParserState m_parser_state;
|
2020-05-02 18:46:39 +00:00
|
|
|
Vector<ParserState> m_saved_state;
|
2020-03-11 18:27:43 +00:00
|
|
|
};
|
|
|
|
}
|