获取指定Cookie信息

获取指定Cookie信息 用于根据 Cookie 名称精确查找并返回对应的 Cookie 对象。它支持按指定 URL 或当前网页对象获取，常用于登录态校验、会话信息提取和 Cookie 属性检查。

指令标识：GetSelectSpecifyCookie
指令类型：网页指令
指令描述：获取指定 URL 网页下指定名称的 Cookie 信息

先选使用方式

工作流支持「可视化编排」和「代码编排」两种创建方式。获取指定Cookie信息 在两种方式里都能用，核心业务参数一致，区别主要是你通过界面配置，还是通过 Python 脚本配置。

方式	怎么用	适合人群
可视化编排（推荐先学）	拖入「获取指定Cookie信息」节点，选择获取方式、填写对应值与 Cookie 名称，设置输出变量	大多数用户，零代码，适合快速搭建和调试
代码编排（Python）	在脚本中调用 `cookie = bots.getSelectSpecifyCookie(value="...", name="...", outKey="cookieInfo")`	熟悉代码、需要复用脚本或批量生成流程的用户

第一次使用建议先用可视化编排跑通，再迁移到 Python 代码编排。下方「参数说明」同时给出界面字段和代码参数名，方便两种方式对应。

什么时候用？

验证特定 Cookie（如 session、token）是否存在，用于判断登录态或权限。
获取 CSRF Token 等 Cookie，用于后续表单提交或接口调用。
获取特定 Cookie 后验证其属性（如 domain、path、secure）。
提取 session ID 或用户标识，用于会话管理或状态跟踪。

使用前确认

目标页面已经打开，且对应 Cookie 已经写入。
你知道要获取的 Cookie 的准确名称（区分大小写）。
按 URL 获取时，URL 需包含协议（http:// 或 https://）。
本指令属于页面读取类，默认失败处理为「报错中止」（STOP_ON_FAILURE）。

可视化编排：从 0 到跑通

先打开目标网站并完成登录，确保目标 Cookie 已写入。
在工作流画布中添加 获取指定Cookie信息 节点。
在 获取方式 选择 URL（按指定 URL 获取）或 OBJECT（按当前网页对象获取）。
在 对应值 中填写对应内容：方式为 URL 时填完整地址，例如 https://example.com。
在 Cookie 名称 中填写要获取的名称，例如 sessionId；在 将结果保存至 中填写变量名，例如 cookieInfo。
运行后查看变量值是否为期望的 Cookie 对象。

参数说明

输入参数

界面名称	代码属性名	类型	必填	默认值	说明
获取方式	`urlWay`	Enum	否	-	高级参数。获取 Cookie 的方式：`URL`（根据指定 URL 获取）、`OBJECT`（根据当前网页对象获取）。
对应值	`value`	String	是	-	所选方式的对应值：方式为 `URL` 时填写完整 URL 地址；方式为 `OBJECT` 时填写网页对象标识，例如 `https://example.com`、`currentPage`。
Cookie 名称	`name`	String	是	-	要获取的 Cookie 名称，需精确匹配，例如 `sessionId`、`userToken`。

输出参数

界面名称	代码属性名	类型	必填	说明
将结果保存至	`outKey`	JSON	是	保存匹配到的 Cookie 对象（包含名称、值、域名、路径等信息）；如果未找到返回 `null`，例如变量名 `cookieInfo`。

成功标准

输出变量得到期望的 Cookie 对象，包含 name、value 等字段。
若目标 Cookie 不存在，输出为 null，符合业务预期。
后续节点能正常引用该 Cookie 信息。

失败排查

现象	可能原因	处理建议
输出为 `null`	Cookie 名称写错或该 Cookie 尚未写入	确认名称大小写完全一致，确认页面已完成登录或操作
取不到登录态 Cookie	页面未完成登录或域名不匹配	先完成登录流程，确认 URL 与 Cookie 的域名一致
节点报错	`对应值` 或 `名称` 为空	确认 `value` 与 `name` 已填写
URL 方式取不到	URL 缺少协议或不可访问	URL 需包含 `http://` 或 `https://` 且可访问

Python 代码编排

代码编排以 Python 为主。运行上下文由代码编排模板创建，示例里只需要关注业务指令本身。

bots.openUrl(url="https://example.com")

# 按指定 URL 获取名为 sessionId 的 Cookie，返回值即 Cookie 对象
cookie = bots.getSelectSpecifyCookie(
    urlWay="URL",
    value="https://example.com",
    name="sessionId",
    outKey="cookieInfo",
)
print(cookie)

如果你想在工作流中通过节点动态编排指令，可使用执行指令（XML）节点。

常见问题

Q1：Cookie 名称是否区分大小写？

A：是的。Cookie 名称区分大小写，必须与实际名称完全匹配，例如 sessionId 和 SessionId 是两个不同的 Cookie。

A：返回结果为 null。建议在后续使用前进行空值判断，避免空指针异常。

Q3：URL 参数必须是什么格式？

A： URL 格式必须正确且可访问，需包含协议（http:// 或 https://），例如 https://example.com。

A：返回单个 Cookie 对象，包含 name、value、domain、path、expires、httpOnly、secure、sameSite 等信息。Cookie 可能包含敏感数据，请注意数据安全与隐私保护。