CKTIS / JavaScript
String.prototype.replaceAll — substituir todas as correspondências
replaceAll substitui todas as correspondências não sobrepostas de uma cadeia de caracteres ou expressão regular global sem alterar a cadeia original. A substituição pode ser texto ou uma função.
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
text.replaceAll(searchValue, replaceValue)Com um padrão de cadeia de caracteres, String.prototype.replaceAll devolve uma cadeia em que todas as correspondências não sobrepostas são substituídas da esquerda para a direita. Não altera a cadeia original nem volta a procurar no texto inserido. Se não houver correspondências, o conteúdo do resultado mantém-se inalterado. Ao contrário de replace com um padrão de cadeia, não para após a primeira correspondência.
Um searchValue de tipo cadeia é interpretado literalmente: "." significa um ponto, não qualquer carácter. Uma expressão regular tem de ter a flag g; se não a tiver, é lançado um TypeError. Um padrão de cadeia vazio corresponde a cada limite de unidade de código UTF-16, incluindo o início e o fim: "ab".replaceAll("", "-") produz "-a-b-". Um objeto com um método [Symbol.replace] pode assumir a operação e determinar o respetivo resultado.
replaceValue pode ser texto ou uma função. No texto de substituição, $$ significa um símbolo de dólar e $& representa a correspondência; as expressões regulares também permitem referências a grupos de captura. Para inserir literalmente texto dinâmico que contenha estas sequências, utiliza () => replacement. Com um padrão de cadeia, a função recebe (match, offset, string); com uma expressão regular, recebe também os grupos de captura antes do offset e, se existirem grupos com nome, um objeto de grupos com nome no fim.
Este método faz parte do ECMAScript 2021, não das Web APIs. A especificação não é uma tabela de compatibilidade dos browsers; a presença do Node 24 num repositório não comprova o suporte nos browsers. Verifica o ambiente de destino, por exemplo com typeof String.prototype.replaceAll === "function".
Exemplos
const text = "a.b.a";
console.log(text.replaceAll(".", "-"));
console.log(text.replaceAll(/a/g, "A"));
console.log(text.replaceAll("a", () => "$&"));
console.log(text);Resultado
a-b-a A.b.A $&.b.$& a.b.a
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.