String.prototype.trim()

Résumé

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()

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'excemple qui suit affiche la chaîne 'toto' :

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

// Et ensuite on retire des blancs uniquement à droite :
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) {
  (function() {
    // On s'assure de bien retirer BOM et NBSP
    var rtrim = /^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g;
    String.prototype.trim = function() {
      return this.replace(rtrim, '');
    };
  })();
}

Spécifications

Spécification Status 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 6 (ECMA-262)
La définition de 'String.prototype.trim' dans cette spécification.
Draft  

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, customcommander, ferncoder, Goofy, sylvain_floury
Dernière mise à jour par : SphinxKnight,
Masquer la barre latérale