Skip to content
YosoiDocs

Observation

yosoi.browser.Observation

class Observation(ImmutableModel):

Retain browser evidence from a particular document epoch.

Evidence describes an observation at capture time and does not grant live tab authority.

Attributes: browser: Optional native-engine provenance; absent in legacy records. id: Observation identity. session_id: Identity of the Session that produced the observation. tab_id: Identity of the observed tab. document_epoch: Unsigned document generation used to fence stale observations. html: Captured HTML when this observation carries DOM evidence. url: Observed URL when present. screenshot: Optional screenshot bytes; JSON encoding uses base64.

Source: python/yosoi/browser.py:901

Members below are declared on this class. Inherited Pydantic methods and generated constructor signatures are not expanded.

model_config = ConfigDict(ser_json_bytes='base64', val_json_bytes='base64')
id: StrictStr
browser: BrowserExecutionIdentity | None = Field(default=None, exclude_if=lambda value: value is None)
session_id: StrictStr
tab_id: StrictStr
document_epoch: U64
html: StrictStr | None = None
url: StrictStr | None = None
screenshot: StrictBytes | None = None
@property
def screenshot_bytes(self) -> bytes | None:

Return retained screenshot bytes, or None when no image was captured.

Source: python/yosoi/browser.py:943