Regex reference

[Josh-Cena]

Description

See mdn/mdn-community#196

Draft as a demo

Related issues and pull requests

• feat(JS): Add JS regex patterns browser-compat-data#18966
• Regular expressions, align title/URL with content browser-compat-data#19050

[github-actions]

Preview URLs (28 pages)

• /en-US/docs/Mozilla/Firefox/Releases/78
• /en-US/docs/Web/JavaScript/Guide/Regular_expressions/Assertions
• /en-US/docs/Web/JavaScript/Guide/Regular_expressions/Character_classes
• /en-US/docs/Web/JavaScript/Guide/Regular_expressions/Cheatsheet
• /en-US/docs/Web/JavaScript/Guide/Regular_expressions/Groups_and_backreferences
• /en-US/docs/Web/JavaScript/Guide/Regular_expressions/Quantifiers
• /en-US/docs/Web/JavaScript/Guide/Regular_expressions
• /en-US/docs/Web/JavaScript/Reference/Deprecated_and_obsolete_features
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp/unicode
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp
• /en-US/docs/Web/JavaScript/Reference/Regular_expressions/Backreference
• /en-US/docs/Web/JavaScript/Reference/Regular_expressions/Capturing_group
• /en-US/docs/Web/JavaScript/Reference/Regular_expressions/Character_class
• /en-US/docs/Web/JavaScript/Reference/Regular_expressions/Character_class_escape
• /en-US/docs/Web/JavaScript/Reference/Regular_expressions/Character_escape
• /en-US/docs/Web/JavaScript/Reference/Regular_expressions/Disjunction
• /en-US/docs/Web/JavaScript/Reference/Regular_expressions/Input_boundary_assertion
• /en-US/docs/Web/JavaScript/Reference/Regular_expressions/Literal_character
• /en-US/docs/Web/JavaScript/Reference/Regular_expressions/Lookahead_assertion
• /en-US/docs/Web/JavaScript/Reference/Regular_expressions/Lookbehind_assertion
• /en-US/docs/Web/JavaScript/Reference/Regular_expressions/Named_backreference
• /en-US/docs/Web/JavaScript/Reference/Regular_expressions/Named_capturing_group
• /en-US/docs/Web/JavaScript/Reference/Regular_expressions/Non-capturing_group
• /en-US/docs/Web/JavaScript/Reference/Regular_expressions/Quantifier
• /en-US/docs/Web/JavaScript/Reference/Regular_expressions/Unicode_character_class_escape
• /en-US/docs/Web/JavaScript/Reference/Regular_expressions/Wildcard
• /en-US/docs/Web/JavaScript/Reference/Regular_expressions/Word_boundary_assertion
• /en-US/docs/Web/JavaScript/Reference/Regular_expressions

Flaws (5)

Note! 23 documents with no flaws that don't need to be listed. 🎉

URL: /en-US/docs/Web/JavaScript/Reference/Regular_expressions/Named_capturing_group
Title: Named capturing group: (?<name>...)
Flaw count: 1

• bad_bcd_queries:
  • No BCD data for query: javascript.regular_expressions.named_capturing_group

---

URL: /en-US/docs/Web/JavaScript/Reference/Regular_expressions/Unicode_character_class_escape
Title: Unicode character class escape: \p{...}, \P{...}
Flaw count: 1

• bad_bcd_queries:
  • No BCD data for query: javascript.regular_expressions.unicode_character_class_escape

---

URL: /en-US/docs/Web/JavaScript/Reference/Regular_expressions/Non-capturing_group
Title: Non-capturing group: (?:...)
Flaw count: 1

• bad_bcd_queries:
  • No BCD data for query: javascript.regular_expressions.non-capturing_group

---

URL: /en-US/docs/Web/JavaScript/Reference/Regular_expressions/Literal_character
Title: Literal character: a, b
Flaw count: 1

• bad_bcd_queries:
  • No BCD data for query: javascript.regular_expressions.literal_character

---

URL: /en-US/docs/Mozilla/Firefox/Releases/78
Title: Firefox 78 for developers
Flaw count: 1

• macros:
  • /en-US/docs/Web/API/ParentNode/replaceChildren redirects to /en-US/docs/Web/API/Element/replaceChildren

External URLs (17)

URL: /en-US/docs/Web/JavaScript/Reference/Regular_expressions
Title: Regular expressions

• https://en.wikipedia.org/wiki/Regular_expression (1 time) (Note! This may be a new URL 👀)
• https://www.perl.org/ (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/JavaScript/Reference/Regular_expressions/Word_boundary_assertion
Title: Word boundary assertion: \b, \B

• https://unicode.org/Public/UCD/latest/ucd/CaseFolding.txt (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/JavaScript/Reference/Regular_expressions/Character_class_escape
Title: Character class escape: \d, \D, \w, \W, \s, \S

• https://unicode.org/Public/UCD/latest/ucd/CaseFolding.txt (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/JavaScript/Reference/Regular_expressions/Named_capturing_group
Title: Named capturing group: (?<name>...)

• https://eslint.org/docs/rules/prefer-named-capture-group (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/JavaScript/Reference/Regular_expressions/Unicode_character_class_escape
Title: Unicode character class escape: \p{...}, \P{...}

• https://2ality.com/2017/07/regexp-unicode-property-escapes.html (1 time) (Note! This may be a new URL 👀)
• https://en.wikipedia.org/wiki/Unicode_character_property (1 time) (Note! This may be a new URL 👀)
• https://tc39.es/ecma262/ (1 time) (Note! This may be a new URL 👀)
• https://tc39.es/ecma262/multipage/text-processing.html (2 times) (Note! This may be a new URL 👀)
• https://unicode.org/Public/UCD/latest/ucd/PropertyValueAliases.txt (1 time) (Note! This may be a new URL 👀)
• https://unicode.org/reports/tr18/ (2 times) (Note! This may be a new URL 👀)
• https://unicode.org/reports/tr24/ (1 time) (Note! This may be a new URL 👀)
• https://util.unicode.org/UnicodeJsps/character.jsp?a=0061 (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/JavaScript/Guide/Regular_expressions/Groups_and_backreferences
Title: Groups and backreferences

• https://github.com/zloirock/core-js (2 times)
• https://tc39.es/ecma262/multipage/text-processing.html (1 time)

---

URL: /en-US/docs/Web/JavaScript/Guide/Regular_expressions/Assertions
Title: Assertions

• https://tc39.es/ecma262/multipage/text-processing.html (1 time)

---

URL: /en-US/docs/Mozilla/Firefox/Releases/78
Title: Firefox 78 for developers

• https://bugzil.la/1361876 (1 time) (Note! This may be a new URL 👀)

(comment last updated: 2023-05-04 08:17:37)

[Rumyra]

I for one really like the way this is going @Josh-Cena, folks seem quite positive about this content :)

I'll await a little more feedback from others, but I might open a tracking bug for the work moving forward (the roadmap is still a few weeks away which is a shame because this is the perfect thing for it)

[Josh-Cena]

Update: I have completed the scaffolds for all pages, but I'm missing a lot of examples, and I also plan to rearrange documentation about regexes in other places. Now is a good time to comment on the description sections, because I feel like I've stuffed in a lot of obscure details.

[bsmth]

BCD for the patterns has been merged in mdn/browser-compat-data#18966

[github-actions]

This pull request has merge conflicts that must be resolved before it can be merged.

[bsmth]

Looks good @Josh-Cena - thanks for the wonderful improvements here, I'm happy to merge when you are!

One last check about flaws, but I think we're good 👍🏻

[bsmth]

Shows a flaw which I presume is the "no spec found" warning:

https://pr22210.content.dev.mdn.mozit.cloud/en-US/docs/Web/JavaScript/Reference/Regular_expressions/Named_capturing_group#specifications

Are we waiting on a BCD release with the latest data from there?

[Josh-Cena]

I believe the flaw is not about the spec data, as spec data is missing on every page, while the flaw is only raised for certain pages. The flaw may be because Yari does not have the latest BCD? As for the missing spec link, I honestly don't know—I'm as puzzled as you are. https://pr22210.content.dev.mdn.mozit.cloud/en-US/docs/Web/JavaScript/Reference/Regular_expressions/Literal_character does have BCD table, which means mdn/browser-compat-data#19050 is already live, and the APIs ought to have spec links.

[bsmth]

the flaw is only raised for certain pages

That's the strange part - let's merge and keep an eye on this if it's resolved on nightly build, this might be only affecting the PR companion.