Cloudflare Workers KV结合TS时数组拼接的类型报错问题

我在使用 Cloudflare Workers KV 获取字符串数组并拼接时，编写了如下代码：

(await BINDING.get("upcoming", { type: "json" }) ?? []).concat(array)

TypeScript 无法识别返回值为数组，抛出错误：Property 'concat' does not exist on type '{}'。尽管我已经用?? []处理了值为 null 的情况，但类型推断仍未正常工作。

尝试添加泛型时遇到不同报错：

• 使用get<string>时，抛出：

  Argument of type 'string | never[]' is not assignable to parameter of type 'never[]'.
    Type 'string' is not assignable to type 'never[]'.
  

• 使用get<string[]>时，抛出：

  Argument of type 'string[]' is not assignable to parameter of type 'never[]'.
    Type 'string' is not assignable to type 'never'.
  

• 使用get<any>能正常运行，但会丢失concat的智能提示。

附KVNamespace.get的类型定义（BINDING 为 KVNamespace 类型）：

get<ExpectedValue = unknown>(
  key: Key,
  options?: KVNamespaceGetOptions<"json">
): Promise<ExpectedValue | null>;

解决方法 #

方法1：明确泛型与数组类型 #

直接指定泛型为string[]，同时确保拼接的array是string[]类型：

const storedArray = await BINDING.get<string[]>("upcoming", { type: "json" });
const resultArray = (storedArray ?? []).concat(array);

如果array类型不确定，可添加类型断言：

const resultArray = (storedArray ?? []).concat(array as string[]);

方法2：类型断言兜底 #

通过类型断言明确返回值为string[]，同时保留?? []处理null：

(await BINDING.get("upcoming", { type: "json" }) as string[] ?? []).concat(array);

方法3：类型守卫验证（更严谨） #

先验证返回值是否为数组，让TypeScript正确推断类型，同时避免非数组值的潜在问题：

const storedValue = await BINDING.get("upcoming", { type: "json" });
const validArray = Array.isArray(storedValue) ? storedValue : [];
const resultArray = validArray.concat(array);

内容的提问来源于stack exchange，提问作者code913