jrdZddlmZddlZddlZddlZddlmZmZm Z dd Z ddZ ddZ ddZ ddZddZdS)u(Writing the profile a Firefox launch is given, and reading back what it is. ⛔ Leaves, like the ones in `_marshal`: none of them mentions a dispatcher. What they have in common is a different subject - a directory on disk and the `user.js` inside it - which is why they are not in the same module. One `_helpers.py` holding both would be the bucket every project grows and nobody can name. Re-exported from `server.py`: `tests/gates/prefs_byte_parity.py` and the transport tests import `_write_user_js`, `_host_of` and `_domain_matches` from there. ) annotationsN)AnyDictOptional directorystrreturnNonec2tj|ddS)uTake away a profile WE created. Never one the caller named. ⛔ IT MUST NOT RAISE. This runs while the session is already going away, and on Windows a file can still be held for a moment after the process that owned it exits. A profile left behind is a few dozen megabytes; an exception here would be a shutdown that fails for a reason nobody cares about, on a path the caller has already stopped watching. T) ignore_errorsN)shutilrmtree)rs WC:\Projects\Historical\venv\Lib\site-packages\invisible_playwright/_juggler/_profile.py_remove_profilers M)4000000 profile_dirprefsrintcddl}g}|D]}||}t|tr|rdnd}n}t|trt |}nXt|t r"t jt |}n!t jt |}|dt j|d|d| |d d |d z}t|j |d d 5}| |d dddn #1swxYwYt|S)uJThe prefs, into the profile, BEFORE the browser starts. ⛔ WITHOUT THIS THE PYTHON PATH LAUNCHES A BROWSER THAT IS NOT THE PRODUCT, and it does so silently. Two hundred prefs arrive in `firefoxUserPrefs` on every `launch`, and the first draft of this server threw them away and started Firefox on an empty temporary profile. Everything worked - pages loaded, clicks landed, the tests were green - and every stealth declaration the package exists to make was simply absent. It was caught by a closed shadow root, of all things: the engine patch that lets a locator reach inside one is gated on `StealthEngineActive()`, which is a pref. The same probe found the root through `_juggler` directly and lost it through the public API, and the only difference between those two arms was who wrote the profile. A gate for a completely different feature is what made the absence visible; nothing was checking for it directly. ⛔ AND THEY ARE WRITTEN, NOT SENT. Our fork already removed prefs from the protocol - `Browser.enable` does not accept them any more - because a browser configured on the second launch is a browser that was wrong on the first. This mirrors what the driver's `defaultArgs` does, in Python. ⛔ Gecko HAS NO FLOAT PREF TYPE: a fraction must be written as a STRING, or the parser fails on that line and IGNORES EVERY LINE AFTER IT. That is not a hypothetical - `ui.textScaleFactor` written as a number once killed the browser on the second context, and the failure looked nothing like a prefs problem. rNtruefalsez user_pref(z, z);T)exist_ok zuser.jswbutf-8)os isinstanceboolrrfloatjsondumpsappendmakedirsjoinopenpathwriteencodelen) rrrlinesnamevaluerenderedbodyhandles r_write_user_jsr0!s8III E  J Jd  eT " " .!&3vvGHH s # # .5zzHH u % % .z#e**--HHz#e**--H TZ-=-=-=-=xxxHIIIIKK dK+++ 99U  d "D bgll; 22D 9 9+V T[[))***+++++++++++++++ u::s3)E((E,/E, executablecDtj|jdz } |ddD]G}|dr0|dddcSHn#t$rYnwxYwdS) uThe base version, from `application.ini` next to the binary. ⛔ Read, never assumed: this project has three separate incidents where a folder name or a guess about the version sent a whole evening of measurements against the wrong build. zapplication.inirreplace)encodingerrorszVersion==z0.0) pathlibPathparent read_text splitlines startswithsplitstripOSError)r1inilines r _read_versionrC]s ,z " " ),= =C MM7)2"444>JLL 5 5Dz** 5zz#q))!,2244444 5 5      5sA/BB BBparamsc>d|DS)u=The parameters that were actually given, with the absent ones REMOVED. ⛔ IN A CLOSED-WORLD SCHEMA, `null` AND ABSENT ARE DIFFERENT ANSWERS. Juggler validates every field it is handed: an Optional that arrives as `null` is not "not provided", it is a value of the wrong type, and the command is REJECTED at runtime with `Object ".clip" is undefined, but has some scheme`. Measured on 2026-08-28 on `Page.screenshot`, whose clip and quality are both optional and were both being sent as null. ⛔ AND THIS IS NOT DONE INSIDE `Connection.send`, tempting as that is: some commands mean something BY sending null. `Browser.setGeolocationOverride` with `geolocation: null` CLEARS the override, and stripping it there would turn "stop pretending to be somewhere" into "do nothing". ci|] \}}||| S)N).0kvs r z_only_set..~s = = =TQq}Aq}}}r)items)rDs r _only_setrMos  > =V\\^^ = = ==rurlc|ddd}|ddddddS)zCThe host of a url, without importing a parser for three characters.z://r7/r:)r>lower)rNwithout_schemes r_host_ofrUsVYYua((,N   Q ' ' * 0 0a 8 8 ; A A C CCr cookie_domainhostrc|pdd}|r|sdS||kp|d|zS)u⛔ A LEADING DOT MEANS "AND EVERY SUBDOMAIN", and dropping it turns a site-wide cookie into one that matches nothing. Comparing the two strings directly is the version that looks right and returns an empty list..F)lstriprSendswith)rVrWdomains r_domain_matchesr^s[!r ) )# . . 4 4 6 6F u 6> 8T]]3<888r)rrr r )rrrrr r)r1rr r)rDrr r)rNrr r)rVrrWrr r)__doc__ __future__rr r8r typingrrrrr0rCrMrUr^rGrrrbs  #"""""  &&&&&&&&&& 1 1 1 19999x$>>>>$DDDD 999999r