JsExprUtils (Closure Templates)

java.lang.Object
- com.google.template.soy.jssrc.restricted.JsExprUtils

```
public class JsExprUtils
extends Object
```
Common utilities for dealing with JS expressions.
Important: This class may only be used in implementing plugins (e.g. functions, directives).

Method Summary

Methods
Modifier and Type	Method and Description
`static JsExpr`	`concatJsExprs(List<? extends JsExpr> jsExprs)` Builds one JS expression that computes the concatenation of the given JS expressions.
`static JsExpr`	`concatJsExprsForceString(List<? extends JsExpr> jsExprs)` Builds a JS expression which is the string concatenation of individual expressions.
`static JsExpr`	`maybeWrapAsSanitizedContent(SanitizedContent.ContentKind contentKind, JsExpr jsExpr)` Wraps with the proper SanitizedContent constructor if contentKind is non-null.
`static JsExpr`	`maybeWrapAsSanitizedContentForInternalBlocks(SanitizedContent.ContentKind contentKind, JsExpr jsExpr)` Wraps with the proper SanitizedContent constructor if contentKind is non-null, in a way specific for let/param blocks.
`static JsExpr`	`toString(JsExpr expr)`

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

- Method Detail
  - concatJsExprs
```
public static JsExpr concatJsExprs(List<? extends JsExpr> jsExprs)
```
    Builds one JS expression that computes the concatenation of the given JS expressions. The '+' operator is used for concatenation. Operands will be protected with an extra pair of parentheses if and only if needed. The resulting expression is not guaranteed to be a string if the operands do not produce strings when combined with the plus operator; e.g. 2+2 might be 4 instead of '22'.
    
    Parameters:
    jsExprs - The JS expressions to concatentate.
    
    Returns:
    One JS expression that computes the concatenation of the given JS expressions.
  - concatJsExprsForceString
```
public static JsExpr concatJsExprsForceString(List<? extends JsExpr> jsExprs)
```
    Builds a JS expression which is the string concatenation of individual expressions. This doesn't assume that the inputs are necessarily strings, but guarantees that the output is a string.
    
    Parameters:
    jsExprs - The JS expressions to concatentate.
    
    Returns:
    One JS expression that computes the guaranteed string concatenation of the given JS expressions.
  - toString
```
public static JsExpr toString(JsExpr expr)
```
  - maybeWrapAsSanitizedContent
```
public static JsExpr maybeWrapAsSanitizedContent(@Nullable
                                 SanitizedContent.ContentKind contentKind,
                                 JsExpr jsExpr)
```
    Wraps with the proper SanitizedContent constructor if contentKind is non-null.
    
    Parameters:
    contentKind - The kind of sanitized content.
    jsExpr - The expression to wrap.
  - maybeWrapAsSanitizedContentForInternalBlocks
```
public static JsExpr maybeWrapAsSanitizedContentForInternalBlocks(@Nullable
                                                  SanitizedContent.ContentKind contentKind,
                                                  JsExpr jsExpr)
```
    Wraps with the proper SanitizedContent constructor if contentKind is non-null, in a way specific for let/param blocks. We generate slightly different code for param and let blocks so that empty strings evaluate to false; specifically, by not wrapping them in SanitizedContent. However, template return values are not affected, so that the external interface to Soy remains pristine.
    
    Parameters:
    contentKind - The kind of sanitized content.
    jsExpr - The expression to wrap.

Class JsExprUtils

Method Summary

Methods inherited from class java.lang.Object

Method Detail

concatJsExprs

concatJsExprsForceString

toString

maybeWrapAsSanitizedContent

maybeWrapAsSanitizedContentForInternalBlocks