Playwright 无法直接读取 localStorage,必须用 page.evaluate() 在页面上下文中执行 JS 获取;需确保页面加载完成、处理 key 不存在和空格问题,并注意 iframe、跳转时机及加密存储等场景。

Playwright 启动浏览器后无法直接读取 LocalStorage?
因为 Playwright 的 page 实例默认不执行 JavaScript 上下文中的同步读取操作,localStorage 是浏览器环境的 JS API,不能通过 Python 层直接访问。必须用 page.evaluate() 主动在页面上下文中执行 JS 代码来提取。
常见错误是试图用 page.inner_text() 或 page.get_attribute() 去“找” localStorage——它根本不是 DOM 节点,也不在 HTML 属性里。
- 必须用
page.evaluate()执行 JS 表达式,返回值会自动序列化传回 Python - 如果页面还没加载完成(比如重定向中、SPA 初始白屏阶段),
evaluate可能报TimeoutError或返回None,需加page.wait_for_load_state("networkidle")或明确等待某个元素 - 某些网站把 token 存在
sessionStorage或加密字段(如auth_token_v2)里,别只盯localStorage.getItem("token")
如何安全提取 Token:检查存在性 + 处理 null/undefined
直接调用 localStorage.getItem("token") 在 key 不存在时返回 null,Python 接收后是 None,但容易和 JS 层报错混淆。应主动判断并提供 fallback。
示例代码:
使用Anthropic TypeScript SDK对Anthropic API调用进行instrumentation,以记录每个请求的token使用量、延迟和成本。封装anthropic.messages.create方法以捕获API响应中的usage.input_tokens、usage.output_tokens和时间信息。通过AWS SDK v3 CloudWatchLogsClient将结构化日志写入CloudWatch Logs。
立即学习“Python免费学习笔记(深入)”;
token = page.evaluate("""() => {
const t = localStorage.getItem('token') || localStorage.getItem('access_token');
return t && typeof t === 'string' ? t.trim() : null;
}""")
if not token:
raise RuntimeError("Token not found in localStorage")
- 多个 key 名要覆盖:常见有
token、access_token、auth_token、jwt,建议用数组遍历尝试 - 注意字符串前后空格,
.trim()很关键,否则后续请求可能因空格 401 - 避免用
JSON.parse()直接套用——很多 token 是原始字符串(如 JWT),不是 JSON 对象
登录后跳转导致 LocalStorage 读取时机错位?
Playwright 默认不会保留跨页面的 JS 上下文。如果登录是表单提交后 302 跳转或前端路由切换(如 React Router),新页面的 localStorage 需要在新 page 上重新读取,而不是在旧页面上等跳转完再 eval。
- 用
with page.expect_navigation():捕获跳转,再对当前page调用evaluate - 若用
page.goto()加载目标页,确保 URL 是最终登录成功页(如/dashboard),而不是登录页本身 - 某些 SPA 登录后靠 JS 动态写入 token,此时需等关键组件挂载,例如:
page.wait_for_selector("[data-testid='user-menu']", timeout=5000)
Token 是加密或 Base64 编码的怎么办?
部分应用把 token 存成 localStorage.setItem("auth", btoa(JSON.stringify({t: 'xxx'}))),或者用 AES 加密。Playwright 本身不处理解密逻辑,只能提取原始字符串。
- 先用
page.evaluate()提取原始值,再在 Python 中判断是否为 Base64(如长度 % 4 == 0、含+/=) - 不要在
evaluate里调用btoa或atob处理敏感数据——JS 上下文可能被审计工具捕获 - 真正加密的 token 必须查前端源码确认密钥和算法,Playwright 无法绕过业务逻辑
最常被忽略的是:有些网站把 token 存在 iframe 的子页面里,主页面 localStorage 是空的。这时候得先 page.frame_locator() 定位到对应 iframe 再读取。

















