CKTIS / Python
Uniones de tipos: X | Y y X | None
En las anotaciones de tipos, la unión X | Y representa un valor de tipo X o Y, mientras que la unión X | None también admite None. Las anotaciones describen los valores permitidos, pero no imponen automáticamente comprobaciones en tiempo de ejecución.
Versión: Python 3.14; repository image, production runtime not attested
Sintaxis
X | Y
X | NoneCon el comportamiento estándar de |, X | Y crea una unión de tipos equivalente a typing.Union[X, Y]: un valor puede ser de tipo X o Y. Sin embargo, en tiempo de ejecución, una metaclase personalizada puede redefinir __or__. Aunque ambos operandos sean tipos, X | Y puede entonces devolver algo distinto de una unión y, en ese caso, no equivale a typing.Union[X, Y]. Se pueden combinar más tipos, por ejemplo, int | str | None. Aquí, | combina tipos, no valores booleanos. Esta sintaxis está disponible desde Python 3.10; en Python 3.14, los objetos de unión son instancias de typing.Union, y types.UnionType es un alias de esa clase.
Como unión de tipos, X | None representa un valor de tipo X o el valor None y equivale a typing.Optional[X]. No significa que se pueda omitir un argumento: solo un valor predeterminado, como value: int | None = None, permite omitirlo en una llamada. Las anotaciones no comprueban ni convierten argumentos automáticamente durante la ejecución; el código debe gestionar None por sí mismo.
El orden de los miembros no afecta a la igualdad de la unión y los duplicados se eliminan: int | str == str | int y int | str | int == int | str. Las uniones se pueden usar con isinstance() e issubclass(), pero los tipos parametrizados, como list[int], no sirven para esas comprobaciones. La comprobación isinstance([1], int | list[int]) genera TypeError.
Al evaluar una expresión de unión durante la ejecución, no combines un tipo con una referencia textual a una clase: int | "Foo" falla. Si una anotación necesita esa referencia, pon toda la expresión entre comillas: "int | Foo". En el ejemplo, describe gestiona explícitamente None y luego convierte los demás valores en texto.
Identificadores de referencia incluidos en esta entrada: X | None / X | Y type union.
Ejemplos
def describe(value: int | str | None) -> str:
if value is None:
return "missing"
return str(value)
print(describe(7))
print(describe("hello"))
print(describe(None))
print(isinstance("hello", int | str))Resultado
7 hello missing True
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.