AbstractParser

java.lang.Object
- com.oracle.js.parser.AbstractParser

Direct Known Subclasses:: Parser

public abstract class AbstractParser
extends Object

Base class for parsers.

Field Summary

Fields
Modifier and Type	Field and Description
`protected ErrorManager`	`errors` Error manager to report errors.
`protected int`	`finish` Finish position of previous token.
`protected boolean`	`isStrictMode` Is this parser running under strict mode?
`protected int`	`k` Index of current token.
`protected TokenType`	`last` Type of last token.
`protected Lexer`	`lexer` Lexer used to scan source content.
`protected int`	`line` Current line number.
`protected int`	`lineOffset` What should line numbers be counted from?
`protected int`	`linePosition` Position of last EOL + 1.
`protected long`	`previousToken` Previous token - accessible to sub classes
`protected Source`	`source` Source to parse.
`protected int`	`start` Start position of current token.
`protected TokenStream`	`stream` Stream of lex tokens to parse.
`protected long`	`token` Descriptor of current token.
`protected TokenType`	`type` Type of current token.

Constructor Summary

Constructors
Modifier	Constructor and Description
`protected`	`AbstractParser(Source source, ErrorManager errors, boolean strict, int lineOffset)` Construct a parser.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`protected IdentNode`	`createIdentNode(long identToken, int identFinish, com.oracle.truffle.api.strings.TruffleString name)` Creates a new `IdentNode` as if invoked with a `constructor` but making sure that the `name` is deduplicated within this parse job.
`protected ParserException`	`error(JSErrorType errorType, String message)` Report an error.
`protected ParserException`	`error(JSErrorType errorType, String message, long errorToken)` Report an error.
`protected ParserException`	`error(String message)` Report an error.
`protected ParserException`	`error(String message, long errorToken)` Report an error.
`protected void`	`expect(TokenType expected)` Check current token and advance to the next token.
`protected void`	`expectDontAdvance(TokenType expected)` Check current token, but don't advance to the next token.
`protected String`	`expectMessage(TokenType expected)` Generate 'expected' message.
`protected String`	`expectMessage(TokenType expected, long errorToken)`
`protected IdentNode`	`getIdent()` Get ident.
`protected IdentNode`	`getIdentifierName()` Create an IdentNode from the current token
`protected LiteralNode<?>`	`getLiteral()` Create a LiteralNode from the current token
`protected Function<Number,com.oracle.truffle.api.strings.TruffleString>`	`getNumberToStringConverter()` Custom number-to-string converter used to convert numeric property names to strings.
`protected long`	`getToken(int i)` Get the ith token.
`protected Object`	`getValue()` Get the value of the current token.
`protected Object`	`getValue(long valueToken)` Get the value of a specific token
`protected Object`	`getValueNoEscape()` Get the value of the current token.
`protected boolean`	`isIdentifierName()` Check if current token is in identifier name
`protected boolean`	`isIdentifierName(long currentToken)` Check if token is an identifier name
`protected boolean`	`isNonStrictModeIdent()` Certain future reserved words can be used as identifiers in non-strict mode.
`protected static String`	`message(String msgId, IdentNode ident)`
`protected static String`	`message(String msgId, String... args)` Get the message string for a message ID and arguments
`protected TokenType`	`next()` Seek next token that is not an EOL or comment.
`protected TokenType`	`nextOrEOL()` Seek next token or EOL (skipping comments.)
`protected TokenType`	`T(int i)` Return the tokenType of the ith token.
`protected void`	`validateLexerToken(Lexer.LexerToken lexerToken)` Lexer token validation hook for subclasses.
`protected void`	`warning(JSErrorType errorType, String message, long errorToken)` Report a warning to the error manager.

Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - source
```
protected final Source source
```
    Source to parse.
  - errors
```
protected final ErrorManager errors
```
    Error manager to report errors.
  - stream
```
protected TokenStream stream
```
    Stream of lex tokens to parse.
  - k
```
protected int k
```
    Index of current token.
  - previousToken
```
protected long previousToken
```
    Previous token - accessible to sub classes
  - token
```
protected long token
```
    Descriptor of current token.
  - type
```
protected TokenType type
```
    Type of current token.
  - last
```
protected TokenType last
```
    Type of last token.
  - start
```
protected int start
```
    Start position of current token.
  - finish
```
protected int finish
```
    Finish position of previous token.
  - line
```
protected int line
```
    Current line number.
  - linePosition
```
protected int linePosition
```
    Position of last EOL + 1.
  - lexer
```
protected Lexer lexer
```
    Lexer used to scan source content.
  - isStrictMode
```
protected boolean isStrictMode
```
    Is this parser running under strict mode?
  - lineOffset
```
protected final int lineOffset
```
    What should line numbers be counted from?
- Constructor Detail
  - AbstractParser
```
protected AbstractParser(Source source,
                         ErrorManager errors,
                         boolean strict,
                         int lineOffset)
```
    Construct a parser.
    
    Parameters:
    
    source - Source to parse.
    
    errors - Error reporting manager.
    
    strict - True if we are in strict mode
    
    lineOffset - Offset from which lines should be counted
- Method Detail
  - getToken
```
protected final long getToken(int i)
```
    Get the ith token.
    
    Parameters:
    
    i - Index of token.
    
    Returns:
    
    the token
  - T
```
protected final TokenType T(int i)
```
    Return the tokenType of the ith token.
    
    Parameters:
    
    i - Index of token
    
    Returns:
    
    the token type
  - next
```
protected final TokenType next()
```
    Seek next token that is not an EOL or comment.
    
    Returns:
    
    tokenType of next token.
  - nextOrEOL
```
protected final TokenType nextOrEOL()
```
    Seek next token or EOL (skipping comments.)
    
    Returns:
    
    tokenType of next token.
  - message
```
protected static String message(String msgId,
                                String... args)
```
    Get the message string for a message ID and arguments
    
    Parameters:
    
    msgId - The Message ID
    
    args - The arguments
    
    Returns:
    
    The message string
  - message
```
protected static String message(String msgId,
                                IdentNode ident)
```
  - error
```
protected final ParserException error(String message,
                                      long errorToken)
```
    Report an error.
    
    Parameters:
    
    message - Error message.
    
    errorToken - Offending token.
    
    Returns:
    
    ParserException upon failure. Caller should throw and not ignore
  - error
```
protected final ParserException error(JSErrorType errorType,
                                      String message,
                                      long errorToken)
```
    Report an error.
    
    Parameters:
    
    errorType - The error type
    
    message - Error message.
    
    errorToken - Offending token.
    
    Returns:
    
    ParserException upon failure. Caller should throw and not ignore
  - error
```
protected final ParserException error(String message)
```
    Report an error.
    
    Parameters:
    
    message - Error message.
    
    Returns:
    
    ParserException upon failure. Caller should throw and not ignore
  - error
```
protected final ParserException error(JSErrorType errorType,
                                      String message)
```
    Report an error.
    
    Parameters:
    
    errorType - The error type
    
    message - Error message.
    
    Returns:
    
    ParserException upon failure. Caller should throw and not ignore
  - warning
```
protected final void warning(JSErrorType errorType,
                             String message,
                             long errorToken)
```
    Report a warning to the error manager.
    
    Parameters:
    
    errorType - The error type of the warning
    
    message - Warning message.
    
    errorToken - error token
  - expectMessage
```
protected final String expectMessage(TokenType expected)
```
    Generate 'expected' message.
    
    Parameters:
    
    expected - Expected tokenType.
    
    Returns:
    
    the message string
  - expectMessage
```
protected final String expectMessage(TokenType expected,
                                     long errorToken)
```
  - expect
```
protected final void expect(TokenType expected)
                     throws ParserException
```
    Check current token and advance to the next token.
    
    Parameters:
    
    expected - Expected tokenType.
    
    Throws:
    
    ParserException - on unexpected token type
  - expectDontAdvance
```
protected final void expectDontAdvance(TokenType expected)
                                throws ParserException
```
    Check current token, but don't advance to the next token.
    
    Parameters:
    
    expected - Expected tokenType.
    
    Throws:
    
    ParserException - on unexpected token type
  - getValueNoEscape
```
protected final Object getValueNoEscape()
```
    Get the value of the current token. If the current token contains an escape sequence, the method does not attempt to convert it.
    
    Returns:
    
    JavaScript value of the token.
  - getValue
```
protected final Object getValue()
```
    Get the value of the current token.
    
    Returns:
    
    JavaScript value of the token.
  - getValue
```
protected final Object getValue(long valueToken)
```
    Get the value of a specific token
    
    Parameters:
    
    valueToken - the token
    
    Returns:
    
    JavaScript value of the token
  - isNonStrictModeIdent
```
protected final boolean isNonStrictModeIdent()
```
    Certain future reserved words can be used as identifiers in non-strict mode. Check if the current token is one such.
    
    Returns:
    
    true if non strict mode identifier
  - getIdent
```
protected final IdentNode getIdent()
```
    Get ident.
    
    Returns:
    
    Ident node.
  - createIdentNode
```
protected IdentNode createIdentNode(long identToken,
                                    int identFinish,
                                    com.oracle.truffle.api.strings.TruffleString name)
```
    Creates a new IdentNode as if invoked with a constructor but making sure that the name is deduplicated within this parse job.
    
    Parameters:
    
    identToken - the token for the new IdentNode
    
    identFinish - the finish for the new IdentNode
    
    name - the name for the new IdentNode. It will be de-duplicated.
    
    Returns:
    
    a newly constructed IdentNode with the specified token, finish, and name; the name will be deduplicated.
  - isIdentifierName
```
protected final boolean isIdentifierName()
```
    Check if current token is in identifier name
    
    Returns:
    
    true if current token is an identifier name
  - isIdentifierName
```
protected final boolean isIdentifierName(long currentToken)
```
    Check if token is an identifier name
    
    Returns:
    
    true if token is an identifier name
  - getIdentifierName
```
protected final IdentNode getIdentifierName()
```
    Create an IdentNode from the current token
    
    Returns:
    
    an IdentNode representing the current token
  - getLiteral
```
protected final LiteralNode<?> getLiteral()
                                   throws ParserException
```
    Create a LiteralNode from the current token
    
    Returns:
    
    LiteralNode representing the current token
    
    Throws:
    
    ParserException - if any literals fails to parse
  - validateLexerToken
```
protected void validateLexerToken(Lexer.LexerToken lexerToken)
```
    Lexer token validation hook for subclasses.
    
    Parameters:
    
    lexerToken - the lexer token to validate
  - getNumberToStringConverter
```
protected Function<Number,com.oracle.truffle.api.strings.TruffleString> getNumberToStringConverter()
```
    Custom number-to-string converter used to convert numeric property names to strings.
    
    Returns:
    
    custom number-to-string converter or null to use the default converter

Class AbstractParser

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

source

errors

stream

k

previousToken

token

type

last

start

finish

line

linePosition

lexer

isStrictMode

lineOffset

Constructor Detail

AbstractParser

Method Detail

getToken

T

next

nextOrEOL

message

message

error

error

error

error

warning

expectMessage

expectMessage

expect

expectDontAdvance

getValueNoEscape

getValue

getValue

isNonStrictModeIdent

getIdent

createIdentNode

isIdentifierName

isIdentifierName

getIdentifierName

getLiteral

validateLexerToken

getNumberToStringConverter