Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

String.prototype.trimStart() — rimuovere gli spazi iniziali

trimStart() restituisce un testo senza gli spazi iniziali e i terminatori di riga definiti da ECMAScript. Non modifica la stringa originale e conserva i caratteri all’interno del testo e alla fine.

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

Sintassi

string.trimStart()

String.prototype.trimStart() rimuove la sequenza iniziale più lunga di caratteri appartenenti agli insiemi WhiteSpace o LineTerminator di ECMAScript. Include, tra gli altri, spazi, tabulazioni, nuove righe e lo spazio non separabile U+00A0. Questo non significa che vengano rimossi tutti i caratteri Unicode invisibili: U+200B non viene rimosso.

La chiamata string.trimStart() non accetta parametri e restituisce un valore di tipo stringa. Le stringhe sono immutabili, quindi l’originale resta invariato; per usare il risultato, occorre salvarlo o passarlo ad altro codice. I caratteri interni e finali restano intatti. Un testo vuoto e un testo composto soltanto da caratteri rimovibili producono "".

A differenza di trimStart(), trimEnd() rimuove questi caratteri solo dalla fine, mentre trim() li rimuove da entrambe le estremità. Non è possibile specificare un insieme personalizzato di caratteri da rimuovere. Il metodo è generico: usato tramite String.prototype.trimStart.call(value), converte in testo un ricevitore valido; i ricevitori null e undefined causano un TypeError.

Il metodo è stato introdotto in ECMAScript 2019. trimLeft è un alias precedente mantenuto per compatibilità; nel nuovo codice è preferibile trimStart. La specifica del linguaggio non è una tabella di compatibilità dei browser: verifica la disponibilità nell’ambiente di destinazione con typeof String.prototype.trimStart === "function". La presenza di Node 24 in un repository non dimostra il supporto nei browser.

Esempi

const text = "\t\n\u00A0Hello  world  ";
const result = text.trimStart();
console.log(JSON.stringify(result));
console.log(result.endsWith("  "));
console.log(text.startsWith("\t"));

Risultato

"Hello  world  "
true
true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti