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
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.
| Ordinateur | Mobile | Serveur | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
trim | Chrome Support complet 4 | Edge Support complet 12 | Firefox Support complet 3.5 | IE Support complet 9 | Opera Support complet 10.5 | Safari Support complet 5 | WebView Android Support complet ≤37 | Chrome Android Support complet 18 | Firefox Android Support complet 4 | Opera Android Support complet 11 | Safari iOS Support complet 5 | Samsung Internet Android Support complet 1.0 | nodejs Support complet 0.1.100 |
Légende
- Support complet
- Support complet