environmentManager

1const environmentManager: object;

定义位置：packages/query-core/src/environmentManager.ts:32

用于管理 TanStack Query 如何判断当前运行时是否应被视为服务端（server-side），该判断会影响是否禁用重新拉取（refetch）定时器，以及默认 retry 计数和 gcTime 的取值。默认情况下，检测逻辑将缺失 window（或存在 Deno 全局对象）视为服务端环境。

若默认检测逻辑在某些运行时中会得出错误结论，则需覆盖此配置——例如 Service Worker 环境中，window 为 undefined，但该环境实际应按客户端行为处理。

类型声明

isServer

1isServer: () => boolean;

返回当前运行时是否应被视为服务端环境。

返回值

boolean

若运行时被视作服务端，则返回 true。

setIsServer()

1setIsServer(isServerValue: IsServerValue): void;

全局覆盖服务端检测逻辑。

参数

isServerValue

IsServerValue

一个函数，返回运行时是否应被视为服务端。

返回值

void

示例

1import { environmentManager } from '@tanstack/query-core'2 3environmentManager.setIsServer(() => false)