CKTIS / JavaScript
RegExp.prototype.flags — ler as flags de uma expressão regular
A propriedade flags devolve as flags de uma expressão regular como uma cadeia de caracteres numa ordem fixa, independentemente da ordem usada na criação. É um acessor sem setter, não um método.
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.flagsRegExp.prototype.flags é uma propriedade acessora, que se lê como regexp.flags, sem parênteses de chamada. Devolve uma cadeia de caracteres com as flags ativadas; se não houver nenhuma, o resultado é a cadeia vazia "". Não devolve o padrão nem as barras que o delimitam.
As letras são devolvidas na ordem fixa dgimsuvy, omitindo as flags desativadas, e não pela ordem em que foram escritas. O getter lê, pela sequência, as propriedades hasIndices, global, ignoreCase, multiline, dotAll, unicode, unicodeSets e sticky, correspondentes a essas letras. Os valores lidos são convertidos em valores booleanos. O suporte de flags não significa que um motor específico suporte todas as flags mais recentes.
O acessor não tem setter: atribuir um valor a regexp.flags não altera as flags da expressão; numa instância comum em modo estrito, gera um TypeError. Para usar outras flags, cria uma nova expressão, por exemplo new RegExp(regexp.source, "g"). O getter lê propriedades públicas, pelo que substituí-las pode alterar o resultado apresentado sem mudar o comportamento das correspondências.
O exemplo demonstra a normalização da ordem: /cat/mi devolve im. JSON.stringify torna visível como "" a cadeia vazia devolvida por /cat/.
Exemplos
const regexp = /cat/mi;
console.log(regexp.flags);
console.log(JSON.stringify(/cat/.flags));Resultado
im ""
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.