Initial commit
This commit is contained in:
commit
57fc3525eb
7311 files changed
+1291398
No files matched your search
@@ -0,0 +1,310 @@
|
||||
"""Best-effort helpers for keeping background tabs logically active.
|
||||
|
||||
These helpers avoid stealing OS/browser foreground focus while reducing the
|
||||
chance that background visibility checks pause site scripts.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import json
|
||||
import time
|
||||
from typing import Any
|
||||
|
||||
from app.core.config import logger
|
||||
from app.core.driver import driver_for_tab
|
||||
|
||||
BACKGROUND_WAKE_CDP_TIMEOUT = 0.5
|
||||
BACKGROUND_WAKE_JS_TIMEOUT = 0.5
|
||||
_BACKGROUND_WAKE_TIMING_LOG_THRESHOLD = 0.25
|
||||
|
||||
|
||||
def is_page_refresh_error(error: Any) -> bool:
|
||||
"""Return True for the transient exception raised while a document navigates."""
|
||||
text = str(error or "").lower()
|
||||
return (
|
||||
"页面被刷新" in text
|
||||
or "page was refreshed" in text
|
||||
or "page is refreshing" in text
|
||||
or "page refreshed" in text
|
||||
or "try waiting for page refresh" in text
|
||||
)
|
||||
|
||||
|
||||
def _log_wake_timing(reason: str, phase: str, elapsed: float) -> None:
|
||||
if elapsed < _BACKGROUND_WAKE_TIMING_LOG_THRESHOLD:
|
||||
return
|
||||
logger.debug(
|
||||
"[PAGE_WAKE_TIMING] "
|
||||
f"reason={reason or '-'}, phase={phase}, elapsed={elapsed:.2f}s"
|
||||
)
|
||||
|
||||
|
||||
_VISIBILITY_EMULATION_SOURCE = r"""
|
||||
(function() {
|
||||
try {
|
||||
const W = window;
|
||||
const D = document;
|
||||
const firstInstall = !Object.prototype.hasOwnProperty.call(D, "hidden")
|
||||
&& !Object.prototype.hasOwnProperty.call(D, "visibilityState");
|
||||
|
||||
const define = (target, name, descriptor) => {
|
||||
try {
|
||||
Object.defineProperty(target, name, descriptor);
|
||||
return true;
|
||||
} catch (error) {
|
||||
return false;
|
||||
}
|
||||
};
|
||||
const defineGetter = (target, name, value) => define(target, name, {
|
||||
configurable: true,
|
||||
enumerable: true,
|
||||
get: () => value,
|
||||
});
|
||||
const defineValue = (target, name, value) => define(target, name, {
|
||||
configurable: true,
|
||||
enumerable: true,
|
||||
writable: true,
|
||||
value,
|
||||
});
|
||||
|
||||
defineGetter(D, "hidden", false);
|
||||
defineGetter(D, "visibilityState", "visible");
|
||||
defineGetter(D, "webkitHidden", false);
|
||||
defineGetter(D, "webkitVisibilityState", "visible");
|
||||
defineGetter(D, "wasDiscarded", false);
|
||||
defineGetter(D, "prerendering", false);
|
||||
defineValue(D, "hasFocus", function() { return true; });
|
||||
|
||||
defineValue(W, "focus", function() {
|
||||
try { W.dispatchEvent(new Event("focus")); } catch (error) {}
|
||||
return undefined;
|
||||
});
|
||||
defineValue(W, "blur", function() { return undefined; });
|
||||
|
||||
if (firstInstall) {
|
||||
try { D.dispatchEvent(new Event("visibilitychange")); } catch (error) {}
|
||||
try { W.dispatchEvent(new Event("focus")); } catch (error) {}
|
||||
}
|
||||
} catch (error) {
|
||||
try {
|
||||
window.__codexVisibilityEmulationErrorV1 = String(error && error.message ? error.message : error || "");
|
||||
} catch (e) {}
|
||||
}
|
||||
})();
|
||||
""".strip()
|
||||
|
||||
|
||||
def _clear_visibility_emulation_attrs(target: Any) -> None:
|
||||
if target is None:
|
||||
return
|
||||
for attr in (
|
||||
"_codex_visibility_emulation_source",
|
||||
"_codex_visibility_emulation_script_id",
|
||||
):
|
||||
try:
|
||||
delattr(target, attr)
|
||||
except Exception:
|
||||
pass
|
||||
|
||||
|
||||
def install_visibility_emulation(tab: Any, owner: Any = None, *, reason: str = "") -> bool:
|
||||
"""Best-effort patch for visibility/focus APIs on the current tab."""
|
||||
if tab is None:
|
||||
return False
|
||||
|
||||
source = _VISIBILITY_EMULATION_SOURCE
|
||||
owner_attr = "_codex_visibility_emulation_source"
|
||||
script_id_attr = "_codex_visibility_emulation_script_id"
|
||||
state_owner = tab
|
||||
|
||||
if getattr(state_owner, owner_attr, None) != source:
|
||||
try:
|
||||
phase_started = time.perf_counter()
|
||||
try:
|
||||
result = driver_for_tab(tab).run_cdp(
|
||||
"Page.addScriptToEvaluateOnNewDocument",
|
||||
source=source,
|
||||
_timeout=BACKGROUND_WAKE_CDP_TIMEOUT,
|
||||
)
|
||||
finally:
|
||||
_log_wake_timing(
|
||||
reason,
|
||||
"visibility.add_script",
|
||||
time.perf_counter() - phase_started,
|
||||
)
|
||||
setattr(state_owner, owner_attr, source)
|
||||
script_id = ""
|
||||
if isinstance(result, dict):
|
||||
script_id = (
|
||||
result.get("identifier")
|
||||
or result.get("scriptId")
|
||||
or result.get("id")
|
||||
or ""
|
||||
)
|
||||
elif isinstance(result, (str, int, float)):
|
||||
script_id = str(result)
|
||||
if script_id:
|
||||
setattr(state_owner, script_id_attr, str(script_id))
|
||||
except Exception as e:
|
||||
if not is_page_refresh_error(e):
|
||||
logger.debug_throttled(
|
||||
"page_wake.visibility.install",
|
||||
f"[PAGE_WAKE] 预注入可见性模拟失败(忽略): reason={reason or '-'}, error={e}",
|
||||
interval_sec=10.0,
|
||||
)
|
||||
|
||||
try:
|
||||
phase_started = time.perf_counter()
|
||||
try:
|
||||
driver_for_tab(tab).run_js(source, timeout=BACKGROUND_WAKE_JS_TIMEOUT)
|
||||
finally:
|
||||
_log_wake_timing(
|
||||
reason,
|
||||
"visibility.apply_current_page",
|
||||
time.perf_counter() - phase_started,
|
||||
)
|
||||
except Exception as e:
|
||||
if not is_page_refresh_error(e):
|
||||
logger.debug_throttled(
|
||||
"page_wake.visibility.apply",
|
||||
f"[PAGE_WAKE] 当前页可见性模拟失败(忽略): reason={reason or '-'}, error={e}",
|
||||
interval_sec=10.0,
|
||||
)
|
||||
return False
|
||||
|
||||
try:
|
||||
phase_started = time.perf_counter()
|
||||
try:
|
||||
state = driver_for_tab(tab).run_js(
|
||||
"return JSON.stringify({hidden: !!document.hidden, visibilityState: document.visibilityState || '', hasFocus: !!(document.hasFocus && document.hasFocus()), wasDiscarded: !!document.wasDiscarded});",
|
||||
timeout=BACKGROUND_WAKE_JS_TIMEOUT,
|
||||
)
|
||||
finally:
|
||||
_log_wake_timing(
|
||||
reason,
|
||||
"visibility.state_probe",
|
||||
time.perf_counter() - phase_started,
|
||||
)
|
||||
if isinstance(state, str):
|
||||
# P0-2:页面内 JSON.stringify,避免 RemoteObject 泄漏
|
||||
try:
|
||||
state = json.loads(state)
|
||||
except ValueError:
|
||||
state = None
|
||||
if isinstance(state, dict):
|
||||
return (state.get("hidden") is False) and (str(state.get("visibilityState") or "").lower() == "visible")
|
||||
return False
|
||||
except Exception:
|
||||
return False
|
||||
|
||||
|
||||
_VISIBILITY_EMULATION_RESTORE_SOURCE = r"""
|
||||
(function() {
|
||||
try {
|
||||
const W = window;
|
||||
const D = document;
|
||||
|
||||
try { delete D.hidden; } catch (error) {}
|
||||
try { delete D.visibilityState; } catch (error) {}
|
||||
try { delete D.webkitHidden; } catch (error) {}
|
||||
try { delete D.webkitVisibilityState; } catch (error) {}
|
||||
try { delete D.wasDiscarded; } catch (error) {}
|
||||
try { delete D.prerendering; } catch (error) {}
|
||||
try { delete D.hasFocus; } catch (error) {}
|
||||
|
||||
try { delete W.focus; } catch (error) {}
|
||||
try { delete W.blur; } catch (error) {}
|
||||
try { delete W.__codexVisibilityEmulationErrorV1; } catch (error) {}
|
||||
|
||||
try { D.dispatchEvent(new Event("visibilitychange")); } catch (error) {}
|
||||
try { W.dispatchEvent(new Event("focus")); } catch (error) {}
|
||||
} catch (error) {}
|
||||
})();
|
||||
""".strip()
|
||||
|
||||
|
||||
def restore_visibility_emulation(tab: Any, owner: Any = None, *, reason: str = "") -> bool:
|
||||
"""Best-effort restore for visibility/focus API overrides."""
|
||||
if tab is None:
|
||||
return False
|
||||
|
||||
script_ids = []
|
||||
script_id_attr = "_codex_visibility_emulation_script_id"
|
||||
for state_owner in (tab, owner):
|
||||
if state_owner is None:
|
||||
continue
|
||||
script_id = str(getattr(state_owner, script_id_attr, "") or "").strip()
|
||||
if script_id and script_id not in script_ids:
|
||||
script_ids.append(script_id)
|
||||
|
||||
for script_id in script_ids:
|
||||
if script_id:
|
||||
try:
|
||||
phase_started = time.perf_counter()
|
||||
try:
|
||||
driver_for_tab(tab).run_cdp(
|
||||
"Page.removeScriptToEvaluateOnNewDocument",
|
||||
identifier=script_id,
|
||||
_timeout=BACKGROUND_WAKE_CDP_TIMEOUT,
|
||||
)
|
||||
finally:
|
||||
_log_wake_timing(
|
||||
reason,
|
||||
"visibility.remove_script",
|
||||
time.perf_counter() - phase_started,
|
||||
)
|
||||
except Exception:
|
||||
pass
|
||||
|
||||
_clear_visibility_emulation_attrs(tab)
|
||||
if owner is not tab:
|
||||
_clear_visibility_emulation_attrs(owner)
|
||||
|
||||
try:
|
||||
phase_started = time.perf_counter()
|
||||
try:
|
||||
driver_for_tab(tab).run_js(_VISIBILITY_EMULATION_RESTORE_SOURCE, timeout=BACKGROUND_WAKE_JS_TIMEOUT)
|
||||
finally:
|
||||
_log_wake_timing(
|
||||
reason,
|
||||
"visibility.restore_current_page",
|
||||
time.perf_counter() - phase_started,
|
||||
)
|
||||
return True
|
||||
except Exception as e:
|
||||
if not is_page_refresh_error(e):
|
||||
logger.debug_throttled(
|
||||
"page_wake.visibility.restore",
|
||||
f"[PAGE_WAKE] 可见性模拟恢复失败(忽略): reason={reason or '-'}, error={e}",
|
||||
interval_sec=10.0,
|
||||
)
|
||||
return False
|
||||
|
||||
|
||||
def notify_page_navigated(target: Any, reason: str = "page_reload") -> None:
|
||||
"""Notify the command engine that a tab or session has completed navigation or page reload."""
|
||||
if target is None:
|
||||
return
|
||||
try:
|
||||
session = target
|
||||
if not hasattr(session, "notify_navigated") and not (hasattr(session, "id") and hasattr(session, "tab")):
|
||||
session = getattr(target, "_session", None) or getattr(target, "session", None)
|
||||
if session is None:
|
||||
try:
|
||||
from app.core.browser.manager import browser
|
||||
tab_pool = getattr(browser, "_tab_pool", None) or getattr(browser, "tab_pool", None)
|
||||
if tab_pool and hasattr(tab_pool, "get_session_by_tab"):
|
||||
session = tab_pool.get_session_by_tab(target)
|
||||
except Exception:
|
||||
session = None
|
||||
|
||||
if session is not None:
|
||||
if hasattr(session, "notify_navigated") and callable(session.notify_navigated):
|
||||
session.notify_navigated(reason=reason)
|
||||
else:
|
||||
from app.services.command_engine import command_engine
|
||||
if hasattr(command_engine, "notify_tab_navigated"):
|
||||
command_engine.notify_tab_navigated(session, reason=reason)
|
||||
except Exception as e:
|
||||
logger.debug(f"[PAGE_LIFECYCLE] notify_page_navigated failed (ignored): {e}")
|
||||
|
||||
Reference in new issue
Block a user