com.google.javascript.jscomp

Class PolymerPass

java.lang.Object

com.google.javascript.jscomp.NodeTraversal.AbstractPostOrderCallback

com.google.javascript.jscomp.PolymerPass

All Implemented Interfaces:

CompilerPass, HotSwapCompilerPass, NodeTraversal.Callback

final class PolymerPass
extends NodeTraversal.AbstractPostOrderCallback
implements HotSwapCompilerPass

Rewrites "Polymer({})" calls into a form that is suitable for type checking and dead code elimination. Also ensures proper format and types.

Only works with Polymer version 0.8 and above.

Design and examples: https://github.com/google/closure-compiler/wiki/Polymer-Pass

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
(package private) static class	PolymerPass.MemberDefinition Any member of a Polymer element or Behavior.

Field Summary

Fields

Modifier and Type	Field and Description
private AbstractCompiler	compiler
private GlobalNamespace	globalNames
private java.util.Set<java.lang.String>	nativeExternsAdded
private Node	polymerElementExterns
private com.google.common.collect.ImmutableList<Node>	polymerElementProps
private java.util.Map<java.lang.String,java.lang.String>	tagNameMap
(package private) static java.lang.String	VIRTUAL_FILE

Constructor Summary

Constructors

Constructor and Description
PolymerPass(AbstractCompiler compiler)

Method Summary

Modifier and Type	Method and Description
private void	appendPolymerElementExterns(PolymerClassDefinition def) Duplicates the PolymerElement externs with a different element base class if needed.
void	hotSwapScript(Node scriptRoot, Node originalRoot) Process the JS with root node root.
static boolean	isPolymerCall(Node value)
void	process(Node externs, Node root) Process the JS with root node root.
private void	rewriteClassDefinition(Node node, Node parent, NodeTraversal traversal)
void	visit(NodeTraversal traversal, Node node, Node parent) Visits a node in postorder (after its children have been visited).

Methods inherited from class com.google.javascript.jscomp.NodeTraversal.AbstractPostOrderCallback

shouldTraverse

Methods inherited from class java.lang.Object

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

Field Detail

VIRTUAL_FILE

static final java.lang.String VIRTUAL_FILE

See Also:

Constant Field Values

compiler

private final AbstractCompiler compiler

tagNameMap

private final java.util.Map<java.lang.String,java.lang.String> tagNameMap

polymerElementExterns

private Node polymerElementExterns

nativeExternsAdded

private java.util.Set<java.lang.String> nativeExternsAdded

polymerElementProps

private com.google.common.collect.ImmutableList<Node> polymerElementProps

globalNames

private GlobalNamespace globalNames

Constructor Detail

PolymerPass

PolymerPass(AbstractCompiler compiler)

Method Detail

process

public void process(Node externs,
                    Node root)

Description copied from interface: CompilerPass

Process the JS with root node root. Can modify the contents of each Node tree

Specified by:

process in interface CompilerPass

Parameters:

externs - Top of external JS tree

root - Top of JS tree

hotSwapScript

public void hotSwapScript(Node scriptRoot,
                          Node originalRoot)

Description copied from interface: HotSwapCompilerPass

Process the JS with root node root. This is supposed to be significantly faster compared to corresponding full-compiler passes.

Specified by:

hotSwapScript in interface HotSwapCompilerPass

Parameters:

scriptRoot - Root node corresponding to the file that is modified, should be of type Token.SCRIPT.

originalRoot - Root node corresponding to the original version of the file that is modified. Should be of type token.SCRIPT.

visit

public void visit(NodeTraversal traversal,
                  Node node,
                  Node parent)

Description copied from interface: NodeTraversal.Callback

Visits a node in postorder (after its children have been visited). A node is visited only if all its parents should be traversed (NodeTraversal.Callback.shouldTraverse(NodeTraversal, Node, Node)).

Implementations can have side effects (e.g. modifying the parse tree).

Specified by:

visit in interface NodeTraversal.Callback

rewriteClassDefinition

private void rewriteClassDefinition(Node node,
                                    Node parent,
                                    NodeTraversal traversal)

appendPolymerElementExterns

private void appendPolymerElementExterns(PolymerClassDefinition def)

Duplicates the PolymerElement externs with a different element base class if needed. For example, if the base class is HTMLInputElement, then a class PolymerInputElement will be added. If the element does not extend a native HTML element, this method is a no-op.

isPolymerCall

public static boolean isPolymerCall(Node value)

Returns:

Whether the call represents a call to the Polymer function.