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.).
Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner https://github.com/mdn/interactive-examples et à envoyer une pull request !
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
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 (ECMA-262) La définition de 'String.prototype.trim' dans cette spécification. |
Standard évolutif |
Compatibilité des navigateurs
BCD tables only load in the browser
Le tableau de compatibilité de cette page a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à envoyer une pull request sur https://github.com/mdn/browser-compat-data.