Package com.google.javascript.jscomp

Class JsMessageExtractor

java.lang.Object

com.google.javascript.jscomp.JsMessageExtractor

public final class JsMessageExtractor
extends Object

Extracts messages and message comments from JS code.

Uses a special prefix (e.g. MSG_) to determine which variables are messages. Here are the recognized formats: var MSG_FOO = "foo"; var MSG_FOO_HELP = "this message is used for foo"; var MSG_BAR = function(a, b) { return a + " bar " + b; } var MSG_BAR_HELP = "the bar message";

This class enforces the policy that message variable names must be unique across all JS files.

Constructor Summary

Constructors

Constructor	Description
JsMessageExtractor(JsMessage.IdGenerator idGenerator)
JsMessageExtractor(JsMessage.IdGenerator idGenerator, CompilerOptions options, boolean extractExternalMessages)

Method Summary

Modifier and Type	Method	Description
Collection<JsMessage>	extractMessages(SourceFile... inputs)	Extracts JS messages from JavaScript code.
Collection<JsMessage>	extractMessages(Iterable<SourceFile> inputs)	Extracts JS messages from JavaScript code.

Methods inherited from class java.lang.Object

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

Constructor Details

JsMessageExtractor

public JsMessageExtractor(JsMessage.IdGenerator idGenerator)

JsMessageExtractor

public JsMessageExtractor(JsMessage.IdGenerator idGenerator,
 CompilerOptions options,
 boolean extractExternalMessages)

Method Details

extractMessages

public Collection<JsMessage> extractMessages(SourceFile... inputs)

Extracts JS messages from JavaScript code.

extractMessages

public Collection<JsMessage> extractMessages(Iterable<SourceFile> inputs)

Extracts JS messages from JavaScript code.

Parameters:

inputs - the JavaScript source code inputs

Returns:

the extracted messages collection

Throws:

RuntimeException - if there are problems parsing the JS code or the JS messages, or if two messages have the same key