Text- und Alltagswerkzeuge · Text-Toolkit
Warum ein Tool zum Suchen und Ersetzen einen halbtypisierten regulären Ausdruck überleben muss
· Warum es wichtig ist
Suchen und Ersetzen reguläre Ausdrücke Textbearbeitung
Die Eingabe eines Musters erfolgt inkrementell, daher ist eine einzelne öffnende Klammer ein normaler Zustand; In diesem Beitrag wird argumentiert, dass das Bewachen der Kompilierung, das Unangetastetlassen von Text und das Anbieten des Rückgängigmachens Korrektheitsmerkmale und kein Feinschliff sind.
Das Tool, das das Problem einer unausgeglichenen Halterung gelöst hat – wie ein Tastendruck eine Stunde Aufräumarbeiten zunichtemachen kann
Ein Feld zum Suchen und Ersetzen enthält oft Arbeiten, deren Zusammenstellung viel länger dauerte als das Suchmuster daneben. Wenn ein unvollständiger Ausdruck durch die Schnittstelle geworfen werden kann, den Editor löscht oder seinen Status unsicher lässt, hat das Tool die Mustereingabe gefährlicher gemacht als die Bereinigungsaufgabe, die es vereinfachen sollte.
Das Repository dokumentiert keinen konkreten Vorfall, bei dem ToolAcre eine Arbeitsstunde vernichtet hat, sodass diese Geschichte nicht als Tatsache dargestellt werden kann. Die vertretbare Anforderung ist ohnehin stärker: Der Benutzertext muss unverändert bleiben, wenn die Musterkompilierung fehlschlägt, unabhängig davon, wie viel Text vorhanden ist oder wie lange die Vorbereitung gedauert hat.
Der destruktive Fehler, den ein Find-and-Replace-Tool verhindern muss
Reguläre Ausdrücke werden normalerweise nicht mit einem einzigen Tastendruck eingegeben. Eine Person gibt eine öffnende Klammer vor der schließenden Klammer ein oder beginnt eine Zeichenklasse mit einer öffnenden Klammer, bevor sie ihre Mitglieder hinzufügt. In diesen Momenten enthält das Feld ein syntaktisch unvollständiges Muster, obwohl der Bearbeitungsprozess normal abläuft.
Die Behandlung dieses vorübergehenden Zustands als außergewöhnliches Benutzerverhalten führt zu einem brüchigen Editor. Die nützliche Reaktion ist sofortiges, lokales Feedback: Zeigen Sie, dass das aktuelle Muster nicht kompiliert werden kann, behalten Sie jedes andere Feld bei und lassen Sie es beim nächsten Tastendruck reparieren. Ein Fehler aufgrund eines ungültigen regulären Ausdrucks sollte den aktuellen Entwurf beschreiben und nicht den Workflow beenden.
Unvollständige Muster sind beim Schreiben eines regulären Ausdrucks normal
ToolAcre leitet jede vom Benutzer bereitgestellte Suche über `compilePattern` weiter. Literale Suchen umgehen zunächst Metazeichen mit regulären Ausdrücken, während der Regex-Modus die angegebene Quelle direkt verwendet. Die Kompilierung erfolgt innerhalb eines `try`-Blocks und ein Fehler gibt ein Nullmuster plus eine Fehlerzeichenfolge zurück, anstatt zuzulassen, dass die JavaScript-Ausnahme in die Schnittstelle entweicht.
Dieses Ergebnis steuert den Ersetzungspfad. Wenn bei der Kompilierung ein Fehler gemeldet wird, gibt `findReplace` den Originaltext, keine Ersetzungen und den Fehler zurück. Es wird nicht versucht, teilweise zu suchen oder neu zu schreiben. Der Wächter schützt daher sowohl die Schnittstellenstabilität als auch die Datenintegrität: Kein gültiges Muster bedeutet keine Mutation der Editorinhalte.
Berichten, was passiert ist – warum eine Ersetzungszählung nach jedem Lauf die schnellste Plausibilitätsprüfung ist
Ein erfolgreicher Ersatz kann immer noch logisch falsch sein. Ein weit gefasster Ausdruck stimmt möglicherweise mit mehr Datumsangaben überein als beabsichtigt, während eine Groß-/Kleinschreibungsoption oder eine Ganzwortgrenze die Menge möglicherweise auf Null reduziert. ToolAcre zählt Übereinstimmungen, bevor es die Standard-Zeichenfolgenersetzung aufruft, und gibt diese Zahl mit dem umgeschriebenen Text zurück, wodurch der Bereich nach jedem Durchlauf sichtbar wird.
Die Zählung ist eher eine schnelle Plausibilitätsprüfung als ein Beweis dafür, dass jede Übereinstimmung wünschenswert war. Wenn zwölf Datensätze erwartet wurden und das Ergebnis 1 oder 1,200 lautet, halten Sie an und überprüfen Sie das Muster, bevor Sie die Ausgabe kopieren. Eine genaue Zahl macht aus einem vagen Verdacht einen konkreten Grund, die Durchsuchung rückgängig zu machen und zu revidieren.
Rückgängigmachen als Sicherheitsnetz – jede Transformation ist umkehrbar, mit einer dokumentierten Grenze von fünfzig Vorgängen
Kompilierungssicherheit verhindert, dass ungültige Muster Text ändern, gültige Muster können jedoch immer noch die falsche Absicht ausdrücken. „Rückgängig“ deckt diese zweite Kategorie ab. Das Text Toolkit zeichnet Transformationen auf, sodass eine abgeschlossene Ersetzung rückgängig gemacht werden kann, wenn die Ergebniszählung oder -ausgabe ergibt, dass die Suche zu umfassend, zu eng oder falsch gruppiert war.
Das dokumentierte Verlaufslimit liegt bei fünfzig Vorgängen, das Rückgängigmachen ist also ein Arbeitspuffer und keine permanente Versionskontrolle. Nutzen Sie es zum Experimentieren in kleinen Schritten, aber betrachten Sie es nicht als Archivspeicher. Bewahren Sie bei wichtigem Material das Original separat auf und kopieren Sie die fertige Ausgabe erst, nachdem Sie sowohl den Text als auch die Anzahl der Ersetzungen überprüft haben.
Funktioniertes Beispiel – Erstellen eines Musters zur Datumsumformatierung Zeichen für Zeichen und Beobachten des Erscheinens und Verschwindens des Fehlers ohne Textverlust
Erwägen Sie eine Änderung der Daten von `2024-01-02` auf `02/01/2024`. Aktivieren Sie Regex und beginnen Sie mit einer öffnenden Klammer. In diesem Moment meldet die Browser-Engine einen ungültigen Ausdruck, ToolAcre zeigt die Nachricht an und der Text bleibt intakt. Fügen Sie `\d{4}` und die schließende Klammer hinzu, und das erste erfasste Jahr wird gültig.
Fahren Sie fort, bis die Suche `(\d{4})-(\d{2})-(\d{2})` lautet, und verwenden Sie dann `$3/$2/$1` als Ersatz. Die drei Erfassungen ordnen Jahr, Monat und Tag neu an, ohne jede Zeile neu eingeben zu müssen. Führen Sie „Alle ersetzen“ aus, vergleichen Sie die gemeldete Anzahl mit den erwarteten Zeilen und machen Sie den Vorgang sofort rückgängig, wenn auch nicht verwandter numerischer Text übereinstimmt.
Was dies nicht abdeckt – Regex-Leistungsprobleme wie katastrophales Backtracking bei großen Eingaben
Der Kompilierungsschutz behebt Syntaxfehler, nicht die Laufzeit gültiger Ausdrücke. Ein Muster kann erfolgreich kompiliert werden, bei bestimmten Eingaben jedoch stark zurückgehen. Da die Ersetzung im Hauptthread ausgeführt wird, kann ein pathologischer Ausdruck, der auf ein großes Dokument angewendet wird, immer noch dazu führen, dass die Browserregisterkarte nicht mehr reagiert, auch wenn keine Ausnahme ausgelöst wurde.
Das Tool führt auch die Funktion „Alle ersetzen“ durch, anstatt die Übereinstimmungen einzeln durchzugehen, und es zeigt hervorgehobene Übereinstimmungen vor der Mutation nicht in der Vorschau an. Aufgrund dieser Grenzwerte sind enge Testdaten und die Anzahl der Ersetzungen wichtig. Validieren Sie einen unbekannten Ausdruck anhand einer kleinen repräsentativen Stichprobe, bevor Sie ihn auf die einzige Kopie eines großen Dokuments anwenden.
Die Erkenntnis: Das Text Toolkit behandelt ungültige Muster als Information und nicht als Fehler, sodass Sie sicher experimentieren können
Ein unvollständiges Muster ist eine Information über einen Bearbeitungsstatus und kein Beweis dafür, dass der Benutzer einen Fehler begangen hat. ToolAcre behält diesen Unterschied in seinen Rückgabewerten bei: Die Kompilierung kann einen Fehler melden, ohne sie auszulösen, die Ersetzung kann keine Änderungen melden, ohne die Quelle zu berühren, und eine erfolgreiche Operation kann genau melden, wie viele Übereinstimmungen sie neu geschrieben hat.
Dieses Design unterstützt das Experimentieren, ohne so zu tun, als wären reguläre Ausdrücke harmlos. Behalten Sie Eingaben bei Kompilierungsfehlern bei, überprüfen Sie die Anzahl nach Erfolg und verwenden Sie „Rückgängig“, wenn ein gültiges Muster konzeptionell falsch war. Zusammengenommen machen diese Verhaltensweisen das Suchen und Ersetzen vorhersehbar genug für gelegentliche Regex-Benutzer, die mehr Feedback als eine Bestrafung für einen halb getippten Ausdruck benötigen.