Ho perso la maggior parte di un pomeriggio una volta a causa di un singolo quantificatore avido Stavo scrivendo una mappa di reindirizzamento per una migrazione WordPress - alcune centinaia di vecchi URL che necessitavano di riscrittura su nuovi slug - e avevo un regex che era supponente per catturare la lumaca finale da ogni percorso. Ha funzionato sui tre URL che ho testato nella mia testa. non ha funzionato sul quarto, che aveva due segmenti di percorso, perché .* aveva ingoiato allegramente il primo taglio e tutto dopo. La regola ha reindirizzato silenziosamente metà del sito nel posto sbagliato e l'ho scoperto da un lettore, non dai miei test, perché il mio "test" stava fissando lo schema e si fidava di esso.
Questo è il problema principale con le espressioni regolari: sono di sola scrittura fino a quando non le esegui contro qualcosa. Un pattern si legge come plausibile fino al momento in cui l'input reale dimostra che è sbagliato e le modalità di guasto sono silenziose. Una regex che corrisponde a nulla genera alcun errore. Una regex che corrisponde troppo non genera alcun errore. Una regex con un gruppo di acquisizione sottilmente sbagliato ti dà la sottostringa sbagliata e va avanti. L'unico modo per sapere che un modello fa quello che pensi è alimentarlo con il testo disordinato e carico di casi di bordo che vedrà effettivamente e espressione a quello che afferra.
un' tester regex chiude quella lacuna Metti il tuo schema in una casella, il tuo testo di esempio in un'altra e ogni corrispondenza si illumina sul posto - con i gruppi di acquisizione suddivisi in modo da poter vedere esattamente quale fetta della stringa è finita nel gruppo 1 rispetto al gruppo 2. quello che ho costruito per Toolz.dev viene eseguito sul browser's nativo RegExp motore, lo stesso utilizzato dal codice JavaScript e TypeScript, quindi quello che vedi nel tester è ciò che ottieni in produzione. Nessuna approssimazione, no "abbastanza vicino".
Questa guida spiega come utilizzare il tester per eseguire il debug velocemente dei modelli, cosa fa effettivamente ogni flag, come vengono visualizzati i gruppi di acquisizione e i gruppi denominati nell'output e le gotcha specifiche di JavaScript che fanno inciampare le persone provenienti da Python o PCRE.
tl; dr: Incolla il tuo modello nel Tester Regex Toolz.dev (nessuna barra necessaria), alternare i flag g/i/m/s/u/y e rilasciare il testo di prova qui sotto. Le partite evidenziano Live con colori alternati, ogni gruppo di acquisizione numerato e denominato è elencato per corrispondenza e gli errori di sintassi mostrano il messaggio esatto del motore. Utilizza il vero motore regexp JavaScript, esegue il lato client al 100%, quindi i registri sensibili non vengono mai caricati e si accoppia con il Costruttore di regex Per assemblare modelli da zero.
Come si testa una regex senza eseguire l'intero programma?
Il modo lento per eseguire il debug di un regex è il ciclo con cui la maggior parte di noi inizia: modifica il modello nel tuo codice, esegui il programma, leggi l'output, indovina cosa è andato storto, ripeti Ogni iterazione costa l'esecuzione completa del programma e il feedback è indiretto: vedi il importanza della partita, non la partita in sé.
Un tester comprime quel ciclo su nulla. Incolla il modello, incolla il testo rappresentativo e vedi immediatamente le corrispondenze. Quando si cambia un carattere nel modello, l'aggiornamento delle luci. Questo stringe il feedback al punto in cui puoi esplorare- prova a + dove avevi un *, aggiungere un confine di parola, rendere un gruppo non cattura - e guardare l'effetto atterrare in tempo reale invece di immaginarlo.
La disciplina chiave è l'utilizzo vero testo di prova, non l'esempio pulito nella tua testa L'URL che ha rotto la mia mappa di reindirizzamento aveva due segmenti di percorso; il mio caso di test mentale ne aveva uno Se avessi incollato l'elenco effettivo dei vecchi URL in un tester, la corrispondenza avida sarebbe stata visibilmente sbagliata sulla riga quattro. Prendi le righe di registro effettive, gli input effettivi dell'utente, i percorsi dei file effettivi - compresi quelli brutti - e lascia che il tester ti mostri dove il modello va in pezzi prima che lo facciano i tuoi utenti.
Cosa cambiano effettivamente i flag regex?
Le bandiere modificano il modo in cui viene applicato l'intero modello e l'incomprensione è dietro una grande parte di "perché non funziona" i momenti. la tester Espone tutti e sei i flag JavaScript durante le interruttori in modo da poterne capovolgere uno e guardare il cambiamento dei risultati.
g - globale. Senza di essa, la corrispondenza si ferma al primo colpo. Con esso, il motore trova ogni corrispondenza nel testo. Nel tester, Global è attivo per impostazione predefinita perché quasi sempre vuoi vedere tutte le partite; disattivalo per confermare come piace una chiamata in single-match String.match senza g tornerebbe.
i - ignoro il caso. rende l'intero modello senza distinzione tra maiuscole e minuscole error fiammiferi Error e ERROR. Semplice e la bandiera più utilizzata dopo G.
m - multilinea. Questo è ampiamente frainteso. lo fa no stringere . Interruzioni di linea incrociate. cambia cosa ^ e $ ancora a: con m, corrispondono all'inizio e alla fine di ciascuno allinearsi, non solo l'inizio e la fine dell'intera stringa. Se stai abbinando riga per riga in un registro, lo desideri.
s - dotAll. questa è la bandiera che fa . Abbina i caratteri di nuova riga. senza di essa, . Corrisponde a qualsiasi carattere eccettuato Un'interruzione di riga, motivo per cui un pattern inteso a coprire più linee spesso si ferma silenziosamente al primo. Se la tua corrispondenza deve superare i limiti della linea, s è ciò di cui hai bisogno - non m.
u - unicode. Abilita la modalità Unicode completa, che rende \u{...} sfugge al lavoro, tratta le coppie surrogate come punti di codice singoli e crea classi di caratteri come \p{Letter} disponibile. Importante quando il tuo testo ha emoji o script non latini.
y - appiccicoso. Ancora ogni partita tenta alla posizione esatta di lastIndex, quindi la corrispondenza riesce solo se inizia esattamente lì. È una bandiera di nicchia utilizzata nei tokenizer e nei parser; la maggior parte del lavoro quotidiano non la tocca mai.
La confusione che costa più tempo è m contro s. Le persone raggiungono la multilinea quando significano dotall. Se il tuo punto non supera le linee, hai bisogno s. Se i tuoi ancoraggi non stanno colpendo i limiti della linea, hai bisogno m. Risolvono diversi problemi e vengono spesso usati insieme.
Come vengono visualizzati i gruppi di cattura nell'output?
Le parentesi in un modello svolgono due lavori: raggruppano sottomodelli per quantificatori o alternanza, e loro cattura la fetta abbinata per l'estrazione. Quando usi un regex per estrarre i dati dal testo: una data e un numero 39; anno e mese, una riga di registro e un livello n. 39;: timestamp e livello: i gruppi di acquisizione sono l'intero punto e sbagliarli è la fonte più comune di & quot; il modello corrisponde ma ho sbagliato stringa.& quot;
la tester Elenca ogni partita con i suoi gruppi di cattura scomposti sotto di essa. Il gruppo 1 è il primo sottomodello tra parentesi, il gruppo 2 il secondo e così via, ciascuno mostrato con il testo esatto che ha acquisito per quella corrispondenza. Questo rende evidenti i bug dei limiti di gruppo: se il Gruppo 1 ha afferrato più di quanto ti aspettassi, puoi vederlo e inserire la parentesi.
I gruppi nominati ricevono lo stesso trattamento. Quando scrivi (?<year>\d{4})-(?<month>\d{2}), il tester mostra le catture per nome - <year> e <month>- accanto ai loro equivalenti numerati, in modo da poter confermare la mappa dei nomi alle sezioni che intendi prima di fare affidamento su match.groups.year nel codice. I gruppi con nome rendono più leggibili i modelli che si auto-documentazione e il codice e vederli risolversi correttamente nel tester è il modo più veloce per fidarsi di loro.
Una trappola correlata Il tester emerge: un gruppo che partecipa al modello ma non corrisponde a un dato tentativo mostra come "nessuna corrispondenza" piuttosto che una stringa vuota. Questa distinzione è importante, perché in JavaScript un tale gruppo lo è undefined, e il codice che presuppone che sia sempre una stringa verrà lanciata. Vederlo segnalato nel tester ti dice di proteggere quell'accesso.
Quale sapore regex è questo, e perché importa?
Le espressioni regolari non sono una lingua. Il modello che funziona in Python re modulo può comportarsi in modo diverso - o buttare - in JavaScript, e viceversa Questo tester utilizza il JavaScript (ECMAScript) motore integrato nel tuo browser, che è byte per byte, viene eseguito lo stesso motore Node.js. Quindi se tu' scrivi codice JavaScript, TypeScript o Node, i risultati qui sono esattamente ciò che farà il tuo codice.
Quella precisione taglia in entrambi i modi. Se copi un modello da una risposta di overflow dello stack scritta per PCRE (PHP e il preg_ funzioni che uso costantemente nel lavoro di WordPress) o per Python, alcune caratteristiche hanno vinto' t tradurre JavaScript storicamente mancava di asserzioni lookbehind, le ha acquisite relativamente di recente e gestisce ancora in modo diverso alcune escape di proprietà Unicode Quantificatori possessivi e gruppi atomici da PCRE don' t esistono in JavaScript a tutti Recursion - una funzionalità PCRE per la corrispondenza di strutture nidificate - non ha equivalenti JavaScript.
Il risultato pratico: prova nel sapore in cui ti distribuirai. Un tester che implementa fedelmente un motore è più utile di uno che implementa una media fuzzy di tutti, perché "ha funzionato nel tester" deve significare "funzionerà nel mio codice.” Per PHP e WordPress tengo a mente le differenze e verificano separatamente lato server; per qualsiasi cosa JavaScript, questo tester è la fonte della verità. Il più ampio toolkit per questo tipo di verifica sensibile alla lingua è trattato nel Guida agli strumenti di codifica.
Quali sono gli usi quotidiani per un tester regex?
Modelli di convalida di costruzione e debug
Campi e-mail, numeri di telefono, codici postali, lumache, stringhe di versione semantica: ogni modulo convalida qualcosa e la convalida è solitamente un regex. Il tester ti consente di lanciare i casi scomodi sul tuo modello prima che venga spedito: l'e-mail con un tag con indirizzo positivo, il numero di telefono con un'estensione, la stringa di versione come 1.10.0 che un modello ingenuo tronca. Incolla una colonna di valori reali e guarda quali non corrispondono.
Estrazione dei dati dai log
I log del server, i log delle applicazioni e le esportazioni CSV sono testo semi-strutturato e regex è il modo in cui tiri fuori i campi Cattura i gruppi afferrano il timestamp, il livello, l'ID della richiesta Il tester' la ripartizione per gruppo di corrispondenza è esattamente la vista che ti serve qui - incolla una dozzina di linee di registro reali, e conferma che ogni campo atterra nel gruppo giusto su tutte, non solo sulla prima riga ordinata Questo si integra con il Flusso di lavoro di debug dell'API dove gli organismi di risposta e le intestazioni vengono raschiati per valori specifici.
Cerca e sostituisci in una base di codice
Editor e IDE supportano la regex nella ricerca e nella sostituzione e un cattivo modello può riscrivere molto più del previsto. testando il pareggiare lato in un tester dedicato prima di eseguire la sostituzione è un'assicurazione a buon mercato - vedere esattamente ciò che il modello seleziona attraverso un campione rappresentativo, quindi eseguire la sostituzione con fiducia Il mio disastro redirect-map è stato fondamentalmente un find-and-replace che non ho mai testato contro input reale prima.
Regex di apprendimento e insegnamento
L'evidenziazione dal vivo rende il tester un vero strumento di apprendimento. Crea un modello un token alla volta e guarda il set di partite restringersi e crescere man mano che aggiungi ancora, quantificatori e classi. visto che \d+ prendi un numero intero e poi \d Prendi una singola cifra per la comprensione di qualsiasi spiegazione in prosa. Quando sei pronto per assemblare un modello da componenti anziché eseguire il debug di uno esistente, il Costruttore di regex è lo strumento di accompagnamento.
Come si evita la trappola della corrispondenza di lunghezza zero?
Un modello che può corrispondere a una stringa vuota - a*, \d*, (foo)?- può & quot; match" in ogni posizione tra i personaggi, producendo un flusso di partite vuote Codice di corrispondenza ingenuo che fa' t avanzare oltre un loop di corrispondenza di lunghezza zero per sempre Il tester si protegge da questo internamente avanzando sempre, quindi non si blocca mai, ma lo farà esibire tu le partite vuote.
Quel display è una caratteristica, non il rumore. Un mucchio di partite vuote è il tester che ti dice che il tuo quantificatore è troppo permissivo. Se intendevi "una o più cifre", hai scritto \d* Quando volevi \d+. Se è necessario un gruppo, lo hai contrassegnato con ?. Vedere le corrispondenze vuote è la diagnostica che ti indica la correzione. Quando il tuo modello è corretto, le corrispondenze sono le sottostringhe a cui tieni e nient'altro.
Regex JavaScript vs altri gusti: un rapido confronto
| caratteristica | javascript (questo tester) | PCRE (PHP) | pitone re |
|---|---|---|---|
| Gruppi nominati | (?<name>...) |
(?<name>...) oppure (?P<name>...) |
(?P<name>...) |
| guardare dietro | Supportato (motori moderni) | supportato | supportato |
| Gruppi atomici / possessivi | non supportato | supportato | limitato |
| ricorsione | non supportato | supportato | non supportato |
| Il flag di nuova riga del punto | s (dota tutto) |
s (dota tutto) |
re.DOTALL |
proprietà unicode \p{...} |
esigenza u imbandiera |
esigenza u modificatore |
regex Solo modulo |
| corrispondenza appiccicosa | y imbandiera |
\G ancora |
\G-come via match collocare |
La lezione della tabella è che "regex" è una famiglia, non uno standard. La sintassi si sovrappone abbastanza per indurti a copiare i modelli tra le lingue e le differenze sono esattamente le funzionalità avanzate che raggiungi in problemi difficili. Prova nel tuo sapore target. Per JavaScript e Node, questo è questo tester; il Toolkit per sviluppatori web Copre dove si adattano gli altri strumenti specifici della lingua.
È sicuro testare la regex rispetto al testo sensibile?
Il testo su cui si verifica la regex è spesso del tipo sensibile: linee di registro di produzione con indirizzi IP e ID utente, esporta con indirizzi e-mail, file di configurazione con nomi host interni. questo è proprio il tuo dato non dovrebbe Incolla in uno strumento che lo spedisce a un server.
la Tester Regex Toolz.dev viene eseguito interamente nel browser La compilazione del modello, la corrispondenza, l'estrazione di gruppo - tutto è JavaScript lato client, senza alcuna richiesta di rete che trasporta il tuo modello o il tuo testo ovunque Taglia la tua connessione dopo il caricamento della pagina e continua a funzionare That' è una garanzia di architettura, non una frase di privacy-policy, e it' è lo stesso principio browser-first dietro ogni strumento nel set, disposto nel Guida alla privacy dei dati.
Ciò significa che puoi incollare le linee di registro reali - quelle con le PII effettive che fanno apparire un modello's edge case - ed eseguire il debug contro di esse in modo sicuro. That's il punto: il tester è utile solo se gli fornisci input reali, e l'input reale è spesso esattamente quello che puoi't inviare a qualcun altro's server.
FAQ
Come posso testare un'espressione regolare online?
Inserisci il tuo modello nel campo del modello senza le barre circostanti, scegli le tue bandiere e incolla il testo di esempio nell'area di prova Le partite si evidenziano istantaneamente e i gruppi di acquisizione sono elencati per ogni corrispondenza Tutto viene eseguito nel tuo browser - non viene caricato nulla.
Che sapore regex usa questo tester?
Utilizza il motore regExp JavaScript (ECMAScript) integrato nel tuo browser, che è identico a quello in Node.js. I risultati corrispondono al modo in cui lo stesso modello si comporta in JavaScript e TypeScript. JavaScript Regex si differenzia da PCRE, modulo RE di Python e modelli Java in alcune funzionalità avanzate come i gruppi atomici e la ricorsione, quindi prova nel sapore in cui distribuirai.
Cosa significano le bandiere regex G, I, M e S?
Il flag g (globale) trova tutte le corrispondenze invece di fermarsi al primo Il flag i rende la corrispondenza insensibile al caso Il flag m (multiline) fa combaciare le ancore ^ e $ alle interruzioni di riga anziché solo l'inizio e la fine della stringa Il flag s (dotAll) consente al punto di abbinare anche i caratteri della nuova riga I flag m e s sono spesso confusi - m cambia le ancore, s cambia il punto.
Come funzionano i gruppi di acquisizione nel tester?
parentesi nel tuo pattern Crea gruppi di acquisizione. Il tester elenca ogni gruppo numerato con il testo che ha catturato per ogni partita, quindi puoi verificare quale fetta della stringa ogni parte del modello afferrata. Gruppi nominati scritti come (?...) sono mostrati per nome insieme ai gruppi numerati.
Perché la mia regex non corrisponde a nulla o genera un errore?
Un modello che corrisponde a nulla di solito ha un carattere sovraspecifico o un carattere speciale non evaso come un punto letterale o un segno più. Un pattern che genera un errore ha un problema di sintassi, come una parentesi sbilanciata o parentesi. Il tester visualizza il messaggio di errore esatto del motore in modo da poter individuare rapidamente il problema.
Come faccio ad abbinare su più righe?
Abilita il flag S (dotall) se hai bisogno del punto per attraversare le interruzioni di riga e abilita il flag M (multilinea) se vuoi che gli ancoraggi ^ e $ corrispondano all'inizio e alla fine di ogni riga. La combinazione di entrambi consente di lavorare in modo naturale con un singolo modello rispetto all'input multilinea come log o righe CSV.
È sicuro testare la regex rispetto ai dati sensibili?
Sì. Tutte le corrispondenze avvengono in JavaScript all'interno del browser - nessun modello o testo di prova viene inviato a qualsiasi server, non viene registrato nulla e lo strumento funziona con la connessione disabilitata Puoi eseguire in sicurezza il test rispetto a file di registro, dati personali o formati proprietari.
Qual è la differenza tra un tester regex e un generatore di regex?
Un tester regex esegue un pattern esistente contro il testo in modo da poterlo verificare ed eseguire il debug, mentre un generatore di regex ti aiuta a costruire un modello da componenti o modelli comuni. Usa il generatore di regex su questo sito per assemblare un modello, quindi portalo al tester per verificarlo rispetto ai dati di esempio reali.
Le espressioni regolari rimangono di sola scrittura finché non le esegui contro input reali e i guasti sono silenziosi: nulla corrisponde, troppe corrispondenze, il gruppo sbagliato cattura e nessun errore ti dice Un tester rende visibile il modello: Incolla la tua regex, alimentalo con il brutto testo reale e guarda esattamente cosa afferra prima che afferri la cosa sbagliata in produzione.
