com.google.javascript.jscomp.deps

Class JsFileParser

java.lang.Object

com.google.javascript.jscomp.deps.JsFileLineParser

com.google.javascript.jscomp.deps.JsFileParser

@GwtIncompatible(value="java.util.regex")
public final class JsFileParser
extends JsFileLineParser

A parser that can extract dependency information from a .js file, including goog.require, goog.provide, goog.module, import statements, and export statements.

Author:

[email protected] (Andrew Grieve)

Field Summary

Fields inherited from class com.google.javascript.jscomp.deps.JsFileLineParser

PARSE_ERROR

Constructor Summary

Constructors

Constructor and Description
JsFileParser(ErrorManager errorManager) Constructor

Method Summary

Modifier and Type	Method and Description
static boolean	isSupported()
protected boolean	parseBlockCommentLine(java.lang.String line)
DependencyInfo	parseFile(java.lang.String filePath, java.lang.String closureRelativePath, java.lang.String fileContents) Parses the given file and returns the dependency information that it contained.
protected boolean	parseLine(java.lang.String line) Parses a line of JavaScript, extracting goog.provide and goog.require information.
JsFileParser	setIncludeGoogBase(boolean include) Sets whether we should create implicit provides and requires of the root namespace.
JsFileParser	setModuleLoader(ModuleLoader loader) Sets a list of "module root" URIs, which allow relativizing filenames for modules.

Methods inherited from class com.google.javascript.jscomp.deps.JsFileLineParser

didParseSucceed, setShortcutMode

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

JsFileParser

public JsFileParser(ErrorManager errorManager)

Constructor

Parameters:

errorManager - Handles parse errors.

Method Detail

setIncludeGoogBase

public JsFileParser setIncludeGoogBase(boolean include)

Sets whether we should create implicit provides and requires of the root namespace. When generating deps files, you do not want this behavior. Deps files need base.js to run anyway, so they don't need information about it. When generating abstract build graphs, you probably do want this behavior. It will create an implicit dependency of all files with provides/requires on base.js.

Returns:

this for easy chaining.

setModuleLoader

public JsFileParser setModuleLoader(ModuleLoader loader)

Sets a list of "module root" URIs, which allow relativizing filenames for modules.

Returns:

this for easy chaining.

parseFile

public DependencyInfo parseFile(java.lang.String filePath,
                                java.lang.String closureRelativePath,
                                java.lang.String fileContents)

Parses the given file and returns the dependency information that it contained.

Parameters:

filePath - Path to the file to parse.

closureRelativePath - Path of the file relative to closure.

fileContents - The contents to parse.

Returns:

A DependencyInfo containing all provides/requires found in the file.

parseBlockCommentLine

protected boolean parseBlockCommentLine(java.lang.String line)

parseLine

protected boolean parseLine(java.lang.String line)
                     throws com.google.javascript.jscomp.deps.JsFileLineParser.ParseException

Parses a line of JavaScript, extracting goog.provide and goog.require information.

Parameters:

line - The line to parse.

Returns:

true to keep going, false otherwise.

Throws:

com.google.javascript.jscomp.deps.JsFileLineParser.ParseException

isSupported

public static boolean isSupported()