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

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

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,