MDN’s new design is in Beta! A sneak peek: https://blog.mozilla.org/opendesign/mdns-new-design-beta/

String.prototype.trim()

O método trim() elimina espaço em branco de ambos os extremos dum string. Espaço em branco neste contexto são todos os caracteres que apenas representam espaço (espaço, tabulação, espaço fixo, etc.) e todos os caracteres que representam limites de linha (LF, CR, etc.).

Sintaxe

str.trim()

Valor devolvido

Um novo string que representa o string que chamou despojado do espaço em branco de ambos os extremos.

Descrição

O método trim() devolve o string despojado do espaço em branco de ambos os extremos. trim() não afecta o valor do string em si.

Exemplos

Using trim()

O exemplo que se segue mostra o string 'foo' em minúsculas:

var orig = '   foo  ';
console.log(orig.trim()); // 'foo'

// Outro exemplo de .trim() eliminando espaço em branco de apenas um lado.

var orig = 'foo    ';
console.log(orig.trim()); // 'foo'

Polyfill

Ao correr o código que se segue antes de qualquer outro criará trim() se não estiver nativamente disponível.

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

Especificações

Especificação Estado Comentário
ECMAScript 5.1 (ECMA-262)
The definition of 'String.prototype.trim' in that specification.
Standard Definição inicial. Implementada em JavaScript 1.8.1.
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'String.prototype.trim' in that specification.
Standard  
ECMAScript Latest Draft (ECMA-262)
The definition of 'String.prototype.trim' in that specification.
Draft  

Compatibilidade de navegadores

Característica Chrome Firefox (Gecko) Internet Explorer Opera Safari
Suporte básico (Yes) 3.5 (1.9.1) 9 10.5 5
Característica Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Suporte básico (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)

Ver também

Etiquetas do documento e contribuidores

 Contribuidores para esta página: ricardomartins
 Última atualização por: ricardomartins,