Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

RegExp.prototype.source — texto do padrão de expressão regular

A propriedade source devolve o texto de um padrão RegExp sem as barras que o delimitam nem as flags. Permite consultar um padrão ou reconstruir uma expressão com new RegExp(), passando as flags separadamente.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

regexp.source

RegExp.prototype.source é uma propriedade de acesso com getter, mas sem setter. Leia-a como regexp.source, sem parênteses de chamada. O resultado é uma string que contém o padrão, sem os delimitadores / que o envolvem nem as flags. As flags podem ser consultadas separadamente através de regexp.flags.

O resultado é adequado para representar o padrão dentro de um literal de expressão regular: as barras e os terminadores de linha são escapados de forma apropriada. Por isso, não tem necessariamente de ser idêntico ao texto passado ao construtor. Para um padrão vazio, new RegExp("").source devolve "(?:)", e não uma string vazia. A leitura de RegExp.prototype.source também devolve "(?:)".

Para reconstruir o padrão e as respetivas flags, use new RegExp(regexp.source, regexp.flags). Isto cria um novo objeto; o estado de lastIndex não é copiado. source não transforma texto arbitrário num padrão literal seguro — os operadores de expressão regular existentes mantêm o seu significado.

O getter requer um objeto RegExp real, sendo o próprio RegExp.prototype uma exceção especial. Chamar o getter com outro recetor provoca um TypeError. Atribuir um valor à propriedade herdada normal source não altera o padrão: provoca um TypeError em modo estrito e é ignorado nos restantes casos.

Exemplos

const pattern = /a\/b+/gi;
const copy = new RegExp(pattern.source, pattern.flags);

console.log(pattern.source);
console.log(pattern.flags);
console.log(copy.test("A/BBB"));
console.log(new RegExp("").source);

Resultado

a\/b+
gi
true
(?:)

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes