Convert a script result into the Python value ``execute_script`` would return. Primitives map to their Python types, arrays and sets to lists, objects and maps to dicts, element nodes to ``WebElement`` and shadow roots to ``ShadowRoot`` (when a driver is given) and windows to their wind
(value: Any, driver: WebDriver | None = None)
| 236 | |
| 237 | |
| 238 | def deserialize_result(value: Any, driver: WebDriver | None = None) -> Any: |
| 239 | """Convert a script result into the Python value ``execute_script`` would return. |
| 240 | |
| 241 | Primitives map to their Python types, arrays and sets to lists, objects |
| 242 | and maps to dicts, element nodes to ``WebElement`` and shadow roots to |
| 243 | ``ShadowRoot`` (when a driver is given) and windows to their window handle. Values with no JSON form, such |
| 244 | as functions, promises and symbols, become ``None``. |
| 245 | """ |
| 246 | if not isinstance(value, dict) or "type" not in value: |
| 247 | return value |
| 248 | kind = value["type"] |
| 249 | inner = value.get("value") |
| 250 | if kind in ("string", "boolean", "date"): |
| 251 | return inner |
| 252 | if kind == "number": |
| 253 | return _SPECIAL_NUMBERS.get(inner, inner) if isinstance(inner, str) else inner |
| 254 | if kind == "bigint": |
| 255 | return int(inner) if inner is not None else None |
| 256 | if kind in _LIST_TYPES: |
| 257 | return [deserialize_result(item, driver) for item in inner or []] |
| 258 | if kind in ("object", "map"): |
| 259 | result = {} |
| 260 | for key, item in inner or []: |
| 261 | result[key if isinstance(key, str) else str(deserialize_result(key, driver))] = deserialize_result( |
| 262 | item, driver |
| 263 | ) |
| 264 | return result |
| 265 | if kind == "regexp": |
| 266 | return inner |
| 267 | if kind == "node": |
| 268 | shared_id = value.get("sharedId") |
| 269 | properties = inner if isinstance(inner, dict) else {} |
| 270 | if not shared_id or driver is None: |
| 271 | return None |
| 272 | if properties.get("nodeType") == _ELEMENT_NODE: |
| 273 | return driver.create_web_element(shared_id) |
| 274 | # Only shadow roots carry a mode; other document fragments have no classic equivalent. |
| 275 | if properties.get("nodeType") == _DOCUMENT_FRAGMENT_NODE and "mode" in properties: |
| 276 | return driver._shadowroot_cls(driver, shared_id) |
| 277 | return None |
| 278 | if kind == "window": |
| 279 | return inner.get("context") if isinstance(inner, dict) else None |
| 280 | return None |
| 281 | |
| 282 | |
| 283 | class Script: |