Filter pending_xref_condition node on failed resolution

1 files changed, 10 insertions, 0 deletions

diff --git a/sphinx/util/nodes.py b/sphinx/util/nodes.py
index 944fd3ecb..22cc9d4c0 100644
--- a/sphinx/util/nodes.py
+++ b/sphinx/util/nodes.py
@@ -531,6 +531,16 @@ def make_id(env: "BuildEnvironment", document: nodes.document,
     return node_id
 
 
+def find_pending_xref_condition(node: addnodes.pending_xref, condition: str) -> Element:
+    """Pick matched pending_xref_condition node up from the pending_xref."""
+    for subnode in node:
+        if (isinstance(subnode, addnodes.pending_xref_condition) and
+                subnode.get('condition') == condition):
+            return subnode
+    else:
+        return None
+
+
 def make_refnode(builder: "Builder", fromdocname: str, todocname: str, targetid: str,
                  child: Node, title: str = None) -> nodes.reference:
     """Shortcut to create a reference node."""