KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

String.raw — ruwe segmenten van template literals

String.raw is een statische methode die als tag van een template literal wordt gebruikt. De methode behoudt de schrijfwijze van reeksen zoals \n in letterlijke tekstsegmenten, maar evalueert ${...}-expressies nog steeds en voegt hun waarden in.

Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

String.raw`text${expression}text`
String.raw(template, ...substitutions)

String.raw is een statische methode, geen methode van een afzonderlijke tekenreeks. Als tag van een template literal voegt de methode de ruwe letterlijke tekstsegmenten samen met de substituties. Een reeks \n in een letterlijk segment levert een backslash en de letter n op, geen newline-teken.

Expressies binnen ${...} worden nog steeds geëvalueerd en hun waarden worden naar tekenreeksen omgezet. De ruwe verwerking geldt voor letterlijke segmenten, niet voor substituties: bevat een gesubstitueerde waarde al een newline-teken, dan blijft dat een newline. De methode maakt eerdere verwerking van escape-reeksen niet ongedaan en biedt geen veilige codering voor HTML of SQL.

Een gewone aanroep, String.raw(template, ...substitutions), is ook mogelijk. De methode leest template.raw als een array-achtig object en vlecht de elementen ervan tussen de substituties. Ontbrekende substituties voegen niets toe, extra substituties worden genegeerd en een raw met lengte nul levert een lege tekenreeks op. Een ontbrekende raw of een waarde null veroorzaakt een TypeError.

In het voorbeeld bevat de eerste regel een letterlijke \n, bevestigt de tweede de inhoud van de tekenreeks en laat de derde de weggelaten substitutie tussen B en C zien.

Voorbeelden

const name = "Ada";
const text = String.raw`Hello\n${name}!`;
console.log(text);
console.log(text === "Hello\\nAda!");
console.log(String.raw({ raw: ["A", "B", "C"] }, 7));

Resultaat

Hello\nAda!
true
A7BC

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen