Регекс, который стоил мне больше всего времени, был регексом, который я не писал. Ему было четыре года, он сидел на уровне проверки и выглядел так, будто кошка ходила по клавиатуре: вложенные группы, предвкушение, два класса персонажей и a {2,} скрываясь в конце. в билете поддержки говорилось, что он отклоняет действительные входные данные, и прежде чем я смог это исправить, я должен был это понять, что означало мысленное управление движком над шаблоном по одному токену за раз. Это налог, который каждый разработчик платит с незнакомого регекса, и это именно налог регулярный выражение на Toolz.dev построен для удаления Это руководство о чтении регулярных выражений вместо их декодирования, и как разбивка по токенам превращает стену символов в то, что вы можете просмотреть, как обычный код.
TL;DR: Объяснитель регексов анализирует регулярное выражение и описывает каждую часть на простом английском языке в том порядке, в котором движок читает его: якоря, классы символов, кванторы, группы, обзоры и побеги, все помечены и отступы, поэтому видна вложенная структура. регулярный выражение проверяет шаблон с помощью реального движка JavaScript и выполняет всю разбивку в вашем браузере, ничего не загружая.
Что такое регекс-объяснитель?
Объяснитель регексов берет регулярное выражение и переводит его, по одной конструкции за раз, в описание, которое вы можете прочитать. Вместо того, чтобы смотреть на ^(?<user>[a-z0-9._%+-]+)@ и реконструируя его значение в голове, вы получаете упорядоченный список: это якорь начала строки, это именованная группа захвата, называемая пользователем, это класс символов, соответствующий строчной букве, цифре, точке, знаку процента, плюсу или дефису, и этот квантор означает один или несколько раз. Шаблон не изменился, но усилия по его пониманию переместились с вашей головы на инструмент.
Значение происходит от того, что регулярные выражения намеренно компактны. каждый символ несет смысл, и одно и то же намерение может быть написано множеством различных способов, поэтому нет надежного способа снять шаблон так, как вы снимаете функцию. одна случайная обратная косая черта меняет буквальную точку на & quot;любой символ, & quot; и жадный квантор, где вы хотели ленивый, меняет текст, который захватывает группа. правильно читать регекс означает моделировать движок, а моделировать движок вручную медленно и подвержено ошибкам. Объяснитель делает это моделирование и показывает вам результат.
На Toolz.dev поток короткий. вы вставляете шаблон без окружающих его косых черт, переключаете используемые флаги, и разбивка появляется сразу. вложенные группы отступают, поэтому форма шаблона видна с первого взгляда, и каждый флаг описывается в контексте, чтобы вы понимали, как он меняет все совпадение, а не только синтаксис.
Чем объяснитель отличается от тестера на регекс?
Эти два инструмента отвечают на разные вопросы, и знание того, что вам нужно, экономит время. тестер регекса запускает шаблон против текста образца и показывает, что он соответствует: выделенные совпадения, группы захвата и любая ошибка. Он отвечает & quot; делает ли этот шаблон то, что я хочу на этом входе. & quot; Объяснитель описывает, что шаблон означает вообще без каких-либо тестовых входов. Он отвечает на & quot; что на самом деле говорит этот шаблон. & quot;
Вы тянетесь к объяснителю, когда регекс - это неизвестное, а не данные. просмотр запроса на извлечение, который добавляет шаблон проверки, наследование кодовой базы, полной недокументированных выражений, или попытка понять ответ, который вы скопировали с форума - все случаи, когда у вас есть шаблон и вам нужно знать, что он делает, прежде чем вы доверитесь ему. Вы тянетесь к Тестер регулярного выражения когда вы уже понимаете шаблон и хотите подтвердить его поведение на фоне реальных примеров. на практике эти двое работают как пара: объясните шаблон, чтобы понять его, затем протестируйте его, чтобы доказать это. Тестер и объяснитель сидят рядом друг с другом на Toolz.dev именно по этой причине.
В семье есть третий инструмент, который стоит назвать The регулярный конструктор собирает шаблон из компонентов и шаблонов, когда вы начинаете с нуля.Постройте, объясните, протестируйте: эти три охватывают полный жизненный цикл работы с регулярным выражением, от написания одного вам еще не нужно понимать то, которое вы не писали.
Что на самом деле показывает поломка?
Объяснитель ходит по шаблону слева направо и выдает одну помеченную строку на конструкцию в том порядке, в котором движок сталкивается с ними. Этот порядок имеет значение, поскольку регулярное выражение читается последовательно, а просмотр токенов в последовательности отражает то, как на самом деле происходит сопоставление.
Якоря стоят на первом месте в большинстве моделей.The ^ а $ символы не соответствуют символам; они утверждают позицию, начало и конец строки или начало и конец каждой строки, когда установлен многострочный флаг. Объяснитель отмечает это двойное поведение, поэтому вас никогда не удивляет якорь, который ведет себя по-другому под m флаг.
Классы символов, записанные в квадратных скобках, описывают один символ, взятый из набора Объяснитель расширяет набор на слова: диапазоны, как a-z стать & quot;диапазон от a до z, & quot; стенография убегает как \d стать & quot; цифрой, & quot; и ведущим каретом становится & quot; любой символ, который НЕ & quot; указанный набор Плотный класс, как [a-zA-Z0-9._%+-] читается как простой список, а не головоломка.
Кванторы - это место, где живут тонкие ошибки, поэтому они получают свои собственные линии. А * равен нулю или больше, + является одним или несколькими, ? это ноль или единица, и {n,m} является явным диапазоном. Важно отметить, что объяснитель помечает ленивые кванторы, написанные с помощью следа ? таких как +? или *?, потому что разница между жадным и ленивым меняется, какой текст захватывает шаблон, не меняя ни одного видимого символа в другом месте.
Группы и обзоры имеют отступы, чтобы показать гнездование. захватывающие группы, группы, не захватывающие, именованные группы и все четыре типа обхода получают описание того, что они делают, и дочерний узор внутри них имеет отступы на один уровень, поэтому структура читается как вложенный контур, а не как плоский ряд символов.
Вот как общие конструкции соответствуют тому, что говорит вам объяснитель:
| Конструировать | пример | Что говорит объяснитель |
|---|---|---|
| Якорь | ^ |
Начало строки (или начало строки с флагом m) |
| класс персонажа | [a-z] |
Один символ из диапазона от a до z |
| Сокращение | \d |
Цифра от 0 до 9 |
| Квантор | {2,} |
Повторяется 2 и более раз |
| Ленивый квантор | +? |
Повторяется один или несколько раз, как можно меньше |
| группа захвата | (...) |
Начало группы захвата, сохраненной для повторного использования |
| Именованная группа | (?<id>...) |
Начало именованной группы захвата & quot;id& quot; |
| Взгляните вперед | (?=...) |
Закрытый узор должен следовать, но не потребляется |
| Обратная ссылка | \1 |
Соответствует той же текстовой группе 1, захваченной |
Описания соответствуют терминологии, используемой в Ссылка на регулярные выражения MDNИтак, если вы хотите читать дальше по какой-либо отдельной конструкции, слова в разбивке - это слова, которые нужно искать.
Почему вкус имеет значение?
Регулярные выражения - это не один язык; они представляют собой семейство близкородственных.JavaScript, PCRE (используется PHP и многими инструментами), Python's re модуль, Java и.NET все разделяют основной синтаксис, но они расходятся по краям, и именно по этим краям возникает путаница. Regex Explainer описывает регулярные выражения JavaScript, вкус, используемый браузерами и Node.js, потому что именно против этого проверяется инструмент и что на самом деле запускает большинство веб-разработчиков.
Общее ядро большое и надежное. классы символов, общие кванторы, чередование с |, группировка, якоря и стандартные сокращения, подобные \d а \w означайте везде одно и то же Если ваш шаблон использует только те, объяснение является точным независимо от языка, на котором вы в конечном итоге запустите его. расхождения находятся в расширенных функциях: lookbehind поддержка пришла поздно в JavaScript и отличается от PCRE, синтаксис именованной группы варьируется между вкусами, а некоторые движки поддерживают рекурсию или притяжательные кванторы, которых JavaScript вообще не имеет.
Практическое правило просто. Отнеситесь к объяснению общих конструкций как к авторитетному, и перепроверьте любое специфичное для вкуса расширение с документацией для вашего целевого языка. потому что объяснитель сначала проверяет шаблон с реальным движком JavaScript, конструкция, которую не поддерживает JavaScript, всплывет как ошибка, а не неправильное объяснение, что является более безопасным сбоем. Если вы работаете через стек так, как я, перемещение между PHP-бэкэндом и JavaScript-фронтендом, явное представление о вкусе спасает класс ошибки, где шаблон, который работал в одном месте, молча неправильно ведет себя в другом.
Как мне прочитать с ним настоящий узор?
Возьмите образец, который инструмент загружает по умолчанию, шаблон в форме электронной почты: ^(?<user>[a-z0-9._%+-]+)@(?<domain>[a-z0-9.-]+\.[a-z]{2,})$ с флагом, нечувствительным к регистру. сам по себе это глоток. Проведите его через объяснитель, и он разложится на короткий, читаемый контур.
выше ^ утверждает начало строки, Первая именованная группа, пользователь, захватывает один или несколько символов из класса строчных букв, цифр и пунктуации, обычно разрешенной в локальной части адреса. Затем буквальный @. Вторая именованная группа, домен, захватывает одну или несколько букв, цифр, точек или дефисов, за которыми следует буквальная точка и серия из двух или более букв, которая является доменом верхнего уровня. Наконец $ утверждает конец строки. The i флаг означает, что все соответствует независимо от падежа, поэтому строчные классы по-прежнему принимают входные данные в верхнем регистре.
Читайте так, выскакивают две вещи, которые невидимы в необработанном шаблоне. Во-первых, {2,} на домене верхнего уровня означает, что шаблон принимает любой TLD из двух или более букв, что правильно для современных доменов, но отклоняет интернационализированный TLD, написанный нелатинскими символами. во-вторых, якоря означают, что шаблон должен соответствовать всей строке, поэтому он проверяет целый адрес, а не находит его внутри большего текста. Это именно те детали, которые определяют, является ли регекс проверки слишком строгим или слишком свободным, и они очевидны в разбивке, но их легко пропустить в оригинале.
Как только вы поймете шаблон, вы часто захотите что-то с ним сделать. Если это шаблон поиска и замены, Регекс Заменить инструмент запускает замену с поддержкой обратной ссылки. Если это шаблон извлечения, Экстрактор электронной почты применяет кураторскую версию именно такого рода сопоставления электронной почты с объемным текстом Объяснитель является шагом чтения; это действующие шаги.
Когда бы я действительно использовал это?
Обзор кода - это случай, в который я попал больше всего Товарищ по команде добавляет регулярное выражение к уровню проверки или анализатору журнала, и diff показывает строку символов без комментариев. Вставка его в объяснитель превращает пятиминутный взгляд в десятисекундное чтение, и он ловит классический обзор промахивается: неэкранированная точка, которая соответствует любому символу, жадный квантор, который захватывает слишком много, якорь, который присутствует или отсутствует, когда это должно быть по-другому. я начал вставлять разбивку в запрос на вытягивание в качестве комментария, который документирует шаблон для следующего человека бесплатно.
Обучение следующее. регулярные выражения - один из тех навыков, которые никогда полностью не прилипают, если вы не используете их ежедневно, и возвращение к ним через несколько месяцев всегда означает переучивание синтаксиса. чтение реальных шаблонов с объяснителем - это более быстрый путь назад, чем перечитывание учебного пособия, потому что вы видите конструкции в контексте, выполняете реальную работу, а не как отдельные примеры. со временем описания становятся ненужными, потому что вы их усвоили, и в этом суть.
Отладка замыкает цикл, Когда шаблон соответствует неправильной вещи, объяснение часто показывает почему, прежде чем вы даже дотянуться до тестового ввода. квантор, который жаден, когда он должен быть ленивым, класс символов, который включает в себя символ, о котором вы забыли, отсутствующий якорь, который позволяет шаблон соответствует подстроке: все это видно в разбивке. я держу объяснитель рядом с Тестер регулярного выражения итак, я могу объяснять и тестировать на одном и том же заседании, и оба живут в более широком наборе, который я описал в Руководство по набору инструментов для разработчиков веб-разработчика, йо-
Частное ли оно, и работает ли оно в офлайне?
Да обоим, и по той же причине. вся разбивка вычисляется в JavaScript внутри вашего браузера. шаблон никогда не отправляется на сервер, ничего не регистрируется, и как только страница загружена, инструмент продолжает работать с вашим соединением отключено. Вы можете подтвердить это, открыв вкладку сети или выйдя в автономном режиме и наблюдая, как она продолжает функционировать.
Это имеет большее значение, чем может показаться для регулярных выражений конкретно. шаблоны часто пишутся, чтобы соответствовать чувствительным форматам: внутренние идентификаторы, формы ключей API, макеты номеров счетов или структура частных данных. вставить один из них в инструмент на стороне сервера означает передать описание вашего формата данных третьей стороне. Сохранение анализа на стороне клиента означает, что шаблон остается на вашей машине, что является тем же принципом конфиденциальности, который стоит за каждым инструментом на Toolz.dev, и один я написал о более полно в Руководство по конфиденциальности данных, йо-
часто задаваемые вопросы
Как понять сложное регулярное выражение?
Вставьте шаблон в объяснитель и прочитайте разбивку по токенам, которая описывает каждую конструкцию на простом английском языке в порядке, в котором движок применяет ее. Вложенные группы имеют отступы, чтобы вы могли видеть структуру. Это превращает мысленное моделирование движка в простое чтение помеченного списка, который быстрее и гораздо менее подвержен ошибкам.
В чем разница между объяснителем регекса и тестером регекса?
Объяснитель регексов описывает, что означает шаблон без какого-либо тестового ввода, в то время как тестер регексов запускает шаблон против текста образца и показывает, что он соответствует. Используйте объяснитель, чтобы понять или задокументировать незнакомый шаблон, затем используйте тестер, чтобы подтвердить, что он ведет себя как ожидается против реальных данных. Они отвечают на разные вопросы и хорошо работают как пара.
Какой вкус регулярного выражения описывает объяснение?
Он описывает регулярные выражения JavaScript (ECMAScript), аромат, используемый браузерами и Node.js. Большинство синтаксиса, включая классы символов, кванторы, группы и якоря, используются совместно с PCRE, Python и Java, поэтому основное объяснение является точным для разных языков. Синтаксис специфичных для вкуса функций, таких как lookbehind и именованная группа, может отличаться, поэтому проверяйте их на соответствие целевому языку.
В чем разница между жадным и ленивым квантификатором?
Жадный квантор, такой как + или *, соответствует как можно большему количеству текста перед возвратом назад, в то время как ленивый квантор, тот же символ, за которым следует ? например +? или *?, совпадает как можно меньше. Объяснитель явно помечает ленивые кванторы, потому что разница меняет текст, который захватывает шаблон, не меняя видимого символа в другом месте.
Может ли объяснение обрабатывать lookahead и lookbehind?
Да. Положительный и отрицательный взгляд вперед, написанный (?=...) и (?!...), и положительный и отрицательный взгляд сзади, написанный (?<=...) и (?<!...), каждый помечен тем, что они утверждают, и имеет отступы, как и другие группы. Звуковые обзоры проверяют, что текст появляется или не появляется в позиции, не включая его в совпадение, что описания делают явным.
Почему в объяснении указано, что мой шаблон недействителен?
Шаблон компилируется с помощью реального движка RegExp до того, как он будет объяснен, поэтому с помощью движка сообщается о несбалансированной скобке или скобке, недопустимом выходе или неизвестном флаге и точном сообщении об ошибке #39;s. Исправьте сообщаемую проблему, чаще всего отсутствующую закрывающую скобку или скобку, и появится поломка.
Безопасно ли вставлять регулярное выражение, соответствующее личным данным?
Да. шаблон анализируется полностью в JavaScript внутри вашего браузера. Он никогда не отправляется на сервер, никогда не регистрируется, и инструмент работает с отключенным соединением после загрузки страницы. Вы можете безопасно объяснить шаблоны из частных кодовых баз или тех, которые соответствуют личным или проприетарным форматам.
Чем это отличается от конструктора регексов?
Строитель regex помогает вам построить новый шаблон из компонентов и шаблонов, когда вы начинаете с нуля, в то время как объяснитель описывает шаблон, который у вас уже есть. эти два понятия дополняют друг друга: построить шаблон с помощью Regex Builder, понять существующий шаблон с помощью объяснителя и подтвердить либо против реального ввода с помощью тестера Regex.
Читайте свои собственные шаблоны с бесплатным регулярный выражение. Он разбивает регулярное выражение по токенам на простом английском языке, полностью в вашем браузере, без загрузки.
