Make it possible to render a Soy template as text without constructing a renderer.

Closure Team · copybara-github · commit d06d21429041 · 2023-06-13T11:38:50.000-07:00
RELNOTES: Make it possible to render a Soy template as text without constructing a renderer.

PiperOrigin-RevId: 540025428
Change-Id: I45ec5fe78a07c7c42e038ef1c33b66e6ecb13b9f
diff --git a/closure/goog/soy/renderer.js b/closure/goog/soy/renderer.js
@@ -128,11 +128,7 @@ class Renderer {
    * @template ARG_TYPES
    */
   renderText(template, templateData = undefined) {
-    const result = template(templateData || {}, this.getInjectedData_());
-    asserts.assertString(
-        result,
-        'renderText was called with a template of kind other than "text"');
-    return String(result);
+    return soy.renderAsText(template, templateData, this.getInjectedData_());
   }
 
   /**
diff --git a/closure/goog/soy/soy.js b/closure/goog/soy/soy.js
@@ -303,6 +303,25 @@ function assertFirstTagValid(html) {
 const INVALID_TAG_TO_RENDER =
     /^<(body|caption|col|colgroup|head|html|tr|td|th|tbody|thead|tfoot)>/i;
 
+/**
+ * Renders a Soy template as test.
+ * @param {function(ARG_TYPES, ?CompatibleIj=): *} template The Soy template to
+ *     render.
+ * @param {ARG_TYPES=} templateData The data for the template.
+ * @param {?Object=} injectedData The injected data for the template.
+ * @return {string}
+ * @template ARG_TYPES
+ */
+function renderAsText(
+    template, templateData = undefined, injectedData = undefined) {
+  const result = template(templateData || defaultTemplateData, injectedData);
+  asserts.assertString(
+      result,
+      'renderText was called with a template of kind other than "text"');
+  return String(result);
+}
+exports.renderAsText = renderAsText;
+
 /**
  * Immutable object that is passed into templates that are rendered
  * without any data.
diff --git a/closure/goog/soy/soy_test.js b/closure/goog/soy/soy_test.js
@@ -250,4 +250,20 @@ testSuite({
         'Expect grandchildDiv to still be contained in childDiv.', childDiv,
         grandchildDiv.parentElement);
   },
+
+  testRenderAsText() {
+    // RenderText works on string templates.
+    assertEquals('<b>XSS</b>', soy.renderAsText(example.stringTemplate));
+    // RenderText on non-text template fails.
+    assertEquals(
+        'Assertion failed: ' +
+            'renderText was called with a template of kind other than "text"',
+        assertThrows(/**
+                      * @suppress {checkTypes} suppression added to enable type
+                      * checking.
+                      */
+                     () => void soy.renderAsText(
+                         example.sanitizedHtmlTemplate, {}))
+            .message);
+  },
 });
