Escape dei caratteri speciali regex per una corrispondenza letterale

Non sempre il testo letterale può essere inserito direttamente in un’espressione regolare. Caratteri come punto, punto interrogativo, parentesi quadra o barra inversa sono istruzioni della sintassi regex: un valore senza escape può quindi trovare il testo sbagliato o rendere non valido il pattern. Questa capacità trasforma una stringa in un frammento di pattern ECMAScript che tratta letteralmente ogni metacarattere regex. È utile quando termini di ricerca, nomi di file, identificatori, etichette o altri valori forniti dagli utenti devono entrare in un’espressione regolare senza cambiare significato.

Trasformi il testo letterale in un frammento sicuro

Invii nel campo text il valore esatto che l’espressione regolare deve riconoscere. Il risultato contiene escaped, un frammento di pattern nel quale ogni metacarattere regex ECMAScript è preceduto da una barra inversa. Lettere, cifre, spazi, punteggiatura priva di significato regex, interruzioni di riga e caratteri Unicode restano invariati.

Per esempio, normalmente un punto rappresenta qualsiasi carattere in un’espressione regolare, mentre un punto con escape indica un punto reale. Le parentesi tonde creano di solito un gruppo, quelle quadre aprono una classe di caratteri, le graffe possono introdurre un numero di ripetizioni e punti interrogativi o asterischi controllano la ripetizione. L’escape di questi simboli conserva il significato letterale del valore originale.

Il frammento restituito non include barre delimitatrici né flag, quindi Lei può passarlo direttamente al costruttore RegExp, inserirlo in un pattern più ampio o salvarlo come corpo del pattern. Una stringa vuota è valida e produce un valore escaped vuoto, poiché non contiene caratteri da trasformare.

Combini il valore con sintassi regex intenzionale

L’escape è particolarmente utile quando una parte del pattern proviene dai dati e un’altra è scritta intenzionalmente come sintassi regex. Supponga che un’applicazione debba trovare all’inizio di una riga un codice prodotto fornito da un utente. Esegua prima l’escape del codice, quindi aggiunga l’ancora iniziale e l’eventuale logica di confine necessaria.

Questa separazione mantiene distinta la struttura affidabile del pattern dal contenuto letterale. Non esegua l’escape dell’intero pattern dopo averlo composto, perché neutralizzerebbe anche ancore, gruppi, alternative o quantificatori che desiderava mantenere attivi. L’output è destinato al corpo di un pattern ECMAScript, non alla notazione del codice sorgente JavaScript.

La distinzione è importante: le barre non sono speciali per il costruttore RegExp e pertanto vengono conservate. Se inserisce il risultato in un letterale regex delimitato da barre all’interno di codice JavaScript generato, l’escape del delimitatore a livello di sorgente è un problema separato. Nel normale codice applicativo, è preferibile passare la stringa restituita a new RegExp e scegliere separatamente i flag.

Conosca la garanzia e verifichi il progetto circostante

La trasformazione è deterministica e lineare: scorre la stringa ricevuta e antepone una barra inversa ai caratteri che controllano la sintassi delle espressioni regolari ECMAScript. Non usa la rete, non esegue l’espressione risultante, non sceglie flag, non aggiunge ancore e non decide se la corrispondenza debba distinguere maiuscole e minuscole. Queste scelte spettano all’applicazione, perché modificano il comportamento della ricerca e non la sicurezza letterale.

Ogni formato ha regole di escape proprie; per combinarle con l’escape regex occorre applicare ogni livello al confine corretto. Dopo la composizione, verifichi il pattern completo con esempi positivi e negativi rappresentativi, soprattutto quando aggiunge sezioni facoltative o alternative intorno al frammento.