Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

String.prototype.concat — unire stringhe

String.prototype.concat aggiunge a una stringa un numero qualsiasi di argomenti, convertendoli in testo. Restituisce un valore primitivo di tipo string e non modifica la stringa originale.

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

str.concat(...args)

String.prototype.concat unisce la stringa del ricevente a zero o più argomenti, nell’ordine indicato. Non inserisce separatori: spazi e segni di punteggiatura devono essere forniti esplicitamente. Il risultato è un valore primitivo di tipo string, non un oggetto String.

Le stringhe sono immutabili: il metodo non modifica il valore originale. Assegna il risultato a una variabile per conservarlo. Una chiamata senza argomenti restituisce invariato il testo del ricevente.

Il ricevente viene convertito per primo in testo, poi vengono convertiti gli argomenti da sinistra a destra usando ToString. Gli argomenti null e undefined producono rispettivamente "null" e "undefined"; un argomento di tipo symbol genera un TypeError. La conversione degli oggetti può eseguire codice personalizzato e generare un’eccezione.

Il metodo è generico: String.prototype.concat.call(42, "!") restituisce "42!". Tuttavia, usare null o undefined come ricevente causa un TypeError. È un metodo dello standard ECMAScript, non un’API del browser.

Esempi

const base = "Level";
const result = base.concat(" ", 3, "!");
console.log(result);
console.log(base);
console.log(base.concat() === base);

Risultato

Level 3!
Level
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