4

Quando se busca uma determinada ocorrência numa string com RegEx sem a flag g (de global), o resultado vêm, além da array com a ocorrência encontrada, outras propriedades, como index, input e groups:

inserir a descrição da imagem aqui

var string = "abc";
var re = string.match(/b/);
console.log("Ocorrência:", re);
console.log("Index:", re.index);
console.log("Input:", re.input);
console.log("Groups:", re.groups);

Minha dúvida é: o que é e pra que serve essa propriedade groups?

Eu achava que seria algum grupo capturado, mas quando coloco o b dentro de parênteses para criar um grupo, mesmo assim a propriedade groups retorna undefined:

inserir a descrição da imagem aqui

var string = "abc";
var re = string.match(/(b)/);
console.log("Ocorrência:", re);
console.log("Index:", re.index);
console.log("Input:", re.input);
console.log("Groups:", re.groups);

1 Resposta 1

5

De acordo com a documentação, a propriedade groups contém os named capturing groups (grupos de captura com nome):

An array of named capturing groups or undefined if no named capturing groups were defined.

Em tradução livre:

Um array de grupos de captura com nome ou undefined se nenhum grupo de captura com nome estiver definido.

Um grupo de captura simples (com somente parênteses) não tem nome, por isso não é retornado em groups. Para ter um grupo com nome, basta usar (?<Nome>:

var string = "abc";
var re = string.match(/(?<letra>b)/);
console.log("Ocorrência:", re);
console.log("Index:", re.index);
console.log("Input:", re.input);
console.log("Groups:", re.groups);

No caso acima, o grupo se chama "letra", e o seu valor é a letra "b".


Lembrando que named capturing groups é um recurso que foi adicionado no ECMAScript 2018.

5
  • 1
    Legal cara! Não sabia disso rs... valeu mesmo!
    – Sam
    Commented 13/05/2019 às 22:59
  • 1
    @Sam O nome da propriedade confunde, né? A primeira vez que vi, tb achei que ela tinha todos os grupos...
    – hkotsubo
    Commented 13/05/2019 às 23:00
  • 1
    Sim, eu achei isso tb rs...
    – Sam
    Commented 13/05/2019 às 23:02
  • 1
    Boa resposta!! Acho que poderia adicionar que esse recurso de grupos nas expressões regulares é de uma versão mais recente do JavaScript. Se não me engano, ES2018! Commented 13/05/2019 às 23:06
  • 1
    @LuizFelipe Eu estava procurando um link com a versão exata. Resposta atualizada, obrigado! :-)
    – hkotsubo
    Commented 13/05/2019 às 23:15

Você deve fazer log-in para responder a esta pergunta.

Esta não é a resposta que você está procurando? Pesquise outras perguntas com a tag .