toStringRepresentation — GTM Variable Template for String

VARIABLES › STRING

toStringRepresentation EXTENDED String

Direct (.tpl) Apply (.tpl) Add to GTM

Converts the provided value to its string representation. Returns the string null for null and undefined for undefined.

---

When to Use This

---

Examples

Number to string▶ Try

INPUT

Value To Convert: 42

OUTPUT

42

Null returns the string null▶ Try

INPUT

Value To Convert: null

OUTPUT

null

Undefined returns the string undefined▶ Try

INPUT

Value To Convert: undefined

OUTPUT

undefined

---

Live Sandbox

This is what you'll see when you open this variable in Google Tag Manager. Hover the icons for details.

toStringRepresentation

Read-Only Try Live

Value To Convert

💾 The value to convert to a string.

Supported formats:
  ✓ Any

Input Setup

Input Function (optional)

⚙️ Optional pre-processing function applied to the value before internal logic (e.g., normalize data, apply calculations). Internal transformations will still apply afterward.

Result Handling

Output Function (optional)

⚙️ Optional function to apply to the result before returning it (e.g., str => str.toUpperCase(), str => str.trim() for whitespace removal). Useful for chaining transformations on the output.

Value To Convert any

💡 Type any text to see the result update live

🎯 Using special value — click input to type instead

Test with:

Falsy undefined null "" empty 0 false NaN

Truthy true 42 "hello" {} empty [] empty {a:1} [1,2,3]

🔗 Result Handling — Chain Variables

Chain apply-mode variables to the output. Each variable receives the result of the previous one.

toStringRepresentation()

+ Chain another variable

---

Related Variables

Same category: String

→ charAt → collapseWhitespace → concat → countWordsInString → endsWith → extract → extractFirstSegment → extractNumber → fromBase64 → indexOf → left → matchAll → matchRegex → normalizeEmail → normalizePhone → padEnd → padStart → parseJSON → replaceAll → replaceAllWithRegex → replaceFirst → right → safeSplit → search → slice → slugify → split → startsWith → stripAccents → stripHtml → substringAfter → substringBefore → test → toBase64 → toCamelCase → toJsonString → toKebabCase → toLocaleLowerCase → toLocaleUpperCase → toLowerCase → toNumber → toSnakeCase → toStartCase → toString → toUpperCase → toUpperFirst → trim → trimEnd → trimStart → truncate

---

Under the Hood

📜 View Implementation Code

/**
 * Converts a value to a string.
 *
 * @param {any} data.val - The value to convert to a string.
 * @param {Function|string} [data.out] - Optional output handler: function to transform result or string with format.
 *
 * Direct-mode specific parameters:
 * @param {Function} [data.pre] - Optional pre-processor function to transform val before conversion.
 *
 * @returns {string} The string representation of the value, or "null" or "undefined" if the value is null or undefined.
 *
 * @framework ggLowCodeGTMKit
 */

const toStringRepresentation = function(value) {
    if (value === null) { return 'null'; }
    if (value === undefined) { return 'undefined'; }
    return value.toString();
};

const safeFunction = fn => typeof fn === 'function' ? fn : x => x;
const out = safeFunction(data.out);

// ===============================================================================
// toStringRepresentation - Direct mode
// ===============================================================================
const applyCast = (castFn, value) => safeFunction(castFn)(value);
const processedValue = applyCast(data.pre, data.val);
return out(toStringRepresentation(processedValue));
// ===============================================================================
// toStringRepresentation() – Apply Mode
// ===============================================================================
/*
return function(value) {
   return out(toStringRepresentation(value));
};
*/

🧪 View Test Scenarios (10 tests)

✅ '[example] Number to string'
✅ Boolean true to string - returns true string
✅ Boolean false to string - returns false string
✅ Array to string - converts array to comma-separated string
✅ Object to string - converts object to string representation
✅ '[example] Null returns the string null'
✅ '[example] Undefined returns the string undefined'
✅ Empty string - returns empty string
✅ Zero number - converts to 0 string
✅ Negative number - converts to string with minus sign