Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Python

typing.NotRequired

Permite omitir uma chave específica de TypedDict mesmo quando as restantes são obrigatórias por predefinição.

Versão: Python 3.14; repository image, production runtime not attested

Sintaxe

note: NotRequired[str]

Permite omitir uma chave específica de TypedDict mesmo quando as restantes são obrigatórias por predefinição.

Omitir um campo de texto é diferente de lhe atribuir None.

Os metadados __optional_keys__ enumeram a chave mas a leitura direta quando falta lança KeyError.

Exemplos

from typing import NotRequired, TypedDict

class Job(TypedDict):
    key: int
    note: NotRequired[str]

job: Job = {"key": 2}
print(sorted(Job.__optional_keys__), "note" in job)
try:
    print(job["note"])
except KeyError:
    print("absent")

Resultado

['note'] False
absent

Os metadados `__optional_keys__` enumeram a chave mas a leitura direta quando falta lança KeyError.

Fontes