python · Fearless-Badger · May 20, 2025 · May 20, 2025
diff --git a/Doc/library/html.parser.rst b/Doc/library/html.parser.rst
@@ -134,7 +134,8 @@ implementations do nothing (except for :meth:`~HTMLParser.handle_startendtag`):
   argument is a list of ``(name, value)`` pairs containing the attributes found
   inside the tag's ``<>`` brackets.  The *name* will be translated to lower case,
   and quotes in the *value* have been removed, and character and entity references
-   have been replaced.
+   have been replaced. If a boolean attribute is encountered, the *value* for the
+   ``(name, value)`` attribute pair will be ``None``.

   For instance, for the tag ``<A HREF="https://www.cwi.nl/">``, this method
   would be called as ``handle_starttag('a', [('href', 'https://www.cwi.nl/')])``.
@@ -310,6 +311,16 @@ further parsing:
   Data     : alert("<strong>hello!</strong>");
   End tag  : script

+Boolean attributes have a *value* of ``None``:
+
+.. doctest::
+
+   >>> parser.feed("<script src='/script.js' defer></script>")
+   Start tag: script
+        attr: ('src', '/script.js')
+        attr: ('defer', None)
+   End tag  : script
+
 Parsing comments:

 .. doctest::