Join MDN and developers like you at Mozilla's View Source conference, 12-14 September in Berlin, Germany. Learn more at https://viewsourceconf.org

String.prototype.trim()

La méthode trim() permet de retirer les blancs en début et fin de chaîne. Les blancs considérés sont les caractères d'espacement (espace, tabulation, espace insécable, etc.) ainsi que les caractères de fin de ligne (LF, CR, etc.).

Syntaxe

str.trim()

Valeur de retour

Une nouvelle chaîne de caractères dérivant de la chaîne appelante pour laquelle les blancs ont été retirés aux deux extrémités de la chaîne.

Description

La méthode trim() renvoie la chaîne sans blanc au début et à la fin. La méthode trim() n'affecte pas la valeur de la chaîne courante.

Exemples

Utiliser trim()

L'exemple qui suit affiche la chaîne 'toto' :

var chaîneOriginale = '   toto  ';
console.log(chaîneOriginale.trim()); // 'toto'

// Un autre exemple de .trim() qui enlève les espaces juste d'un côté

var chaîneOriginale = 'toto    ';
console.log(chaîneOriginale.trim()); // 'toto'

Prothèse d'émulation (polyfill)

Si l'environnement utilisé ne possède pas cette méthode, il est possible de l'émuler avec le fragment de code suivant :

if (!String.prototype.trim) {
  String.prototype.trim = function () {
    return this.replace(/^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g, '');
  };
}

Spécifications

Spécification État Commentaires
ECMAScript 5.1 (ECMA-262)
La définition de 'String.prototype.trim' dans cette spécification.
Standard Définition initiale. Implémentée avec JavaScript 1.8.1.
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de 'String.prototype.trim' dans cette spécification.
Standard  
ECMAScript 2017 Draft (ECMA-262)
La définition de 'String.prototype.trim' dans cette spécification.
Projet  

Compatibilité des navigateurs

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari
Support simple (Oui) 3.5 (1.9.1) 9 10.5 5
Fonctionnalité Android Chrome pour Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Support simple (Oui) (Oui) (Oui) (Oui) (Oui) (Oui)

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : SphinxKnight, teoli, yeraz, customcommander, ferncoder, Goofy, sylvain_floury
 Dernière mise à jour par : SphinxKnight,