Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

RegExp.prototype.flags — leggere i flag delle espressioni regolari

La proprietà flags restituisce i flag di un’espressione regolare come stringa in un ordine fisso, indipendentemente dall’ordine usato al momento della creazione. È un accessor senza setter, non un metodo.

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

Sintassi

regexp.flags

RegExp.prototype.flags è una proprietà accessor, che si legge come regexp.flags, senza parentesi di chiamata. Restituisce una stringa contenente i flag attivi; se non ce ne sono, il risultato è la stringa vuota "". Non restituisce il pattern né le barre che lo racchiudono.

Le lettere vengono restituite nell’ordine fisso dgimsuvy, omettendo i flag disattivati, non nell’ordine in cui sono stati scritti. Il getter legge in sequenza le proprietà hasIndices, global, ignoreCase, multiline, dotAll, unicode, unicodeSets e sticky, corrispondenti a quelle lettere. I valori letti vengono convertiti in valori booleani. Il supporto di flags non dimostra che un determinato motore supporti anche tutti i flag più recenti.

L’accessor non ha un setter: assegnare un valore a regexp.flags non cambia i flag dell’espressione; con un’istanza ordinaria in modalità strict, genera un TypeError. Per usare flag diversi, crea una nuova espressione, per esempio new RegExp(regexp.source, "g"). Il getter legge proprietà pubbliche, quindi sovrascriverle può cambiare il risultato riportato senza modificare il comportamento delle corrispondenze.

L’esempio mostra la normalizzazione dell’ordine: /cat/mi restituisce im. JSON.stringify rende visibile come "" la stringa vuota restituita da /cat/.

Esempi

const regexp = /cat/mi;
console.log(regexp.flags);
console.log(JSON.stringify(/cat/.flags));

Risultato

im
""

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti