本教程旨在解决 k6 性能测试脚本中常见的 `typeerror: value is not an object: undefined` 错误。该错误通常源于错误地尝试导入 k6 的 `open` 函数。`open` 是 k6 初始化上下文中的全局函数，无需显式导入。文章将详细解释错误原因，并提供正确的脚本编写方式，确保外部数据文件能被正确加载，从而顺利执行性能测试。
在进行 k6 性能测试时，我们经常需要从外部文件加载配置或测试数据，例如 API 基地址、用户凭证等。k6 提供了 open() 函数来读取本地文件。然而，不恰当的使用方式，尤其是尝试像导入模块一样导入 open 函数，可能会导致运行时出现 TypeError: Value is not an object: undefined 错误。本文将深入分析这一错误的原因，并提供正确的解决方案。
理解 k6 中的 open() 函数
open() 函数是 k6 提供的一个内置功能，用于在脚本初始化阶段（即 init context）读取本地文件内容。它的主要特点是：
- 全局可用性：open() 函数在 k6 脚本的初始化上下文中是全局可用的，无需通过 import 语句显式导入。这与 http、check、sleep 等需要从 k6/http 或 k6 模块导入的函数不同。
- 执行时机：open() 只能在脚本的顶层作用域或 init context 中调用，用于加载那些在整个测试生命周期中保持不变的配置或数据。它不能在 default function（VU 函数）内部调用。
- 返回值：open() 函数返回文件内容的字符串形式。如果文件是 JSON 格式，通常需要结合 JSON.parse() 来将其转换为 JavaScript 对象。
TypeError: Value is not an object: undefined 错误溯源
当 k6 脚本中出现 TypeError: Value is not an object: undefined 错误，并且错误指向 JSON.parse(open(__ENV.resourseURL)) 这一行时，其根本原因在于错误地尝试导入 open 函数。
考虑以下错误的脚本片段：
import {open} from 'k6'; // 错误：尝试导入 open 函数
const jsonData = JSON.parse(open(__ENV.resourseURL));
const baseURL = jsonData.base_url;在 k6 中，open 函数本身并不存在于任何可导入的模块中。当您尝试 import {open} from 'k6'; 时，JavaScript 模块系统会尝试从 k6 模块中解构名为 open 的导出。由于 k6 模块并没有导出 open，因此 import {open} from 'k6'; 这行代码实际上会将 open 变量赋值为 undefined。
随后，当执行 JSON.parse(open(__ENV.resourseURL)) 时，实际上是在调用 JSON.parse(undefined(__ENV.resourseURL))。undefined 并不是一个函数，因此尝试调用它会导致 TypeError。更具体地说，由于 open 此时是 undefined，JSON.parse 接收到的参数就是 undefined，而 JSON.parse 期望的是一个字符串，所以它会抛出 TypeError: Value is not an object: undefined。
解决方案：移除不必要的导入
解决这个 TypeError 的方法非常简单：移除所有尝试导入 open 函数的语句。 由于 open 函数是全局可用的，您只需直接调用它即可。
以下是修正后的 k6 脚本示例：
import http from 'k6/http';
import { check, sleep } from 'k6'; // 导入其他必要的模块和函数
// 正确的使用方式：open 函数无需导入，直接调用即可
const jsonData = JSON.parse(open(__ENV.resourseURL));
const baseURL = jsonData.base_url;
export let options = {
vus: 10, // 模拟的虚拟用户数量
duration: '1m', // 测试持续时间
};
export default function () {
// 发送 HTTP GET 请求
let response = http.get(baseURL);
// 断言响应状态码为 200
check(response, { 'Status is 200': (r) => r.status === 200 });
// 在下一次迭代前暂停 1 秒
sleep(1);
}配合 data.json 文件：
{
"base_url": "https://gorest.co.in/public/v2/users"
}以及运行命令：
k6 run --env resourseURL=data.json Sample.js
通过移除 import {open} from 'k6'; 这一行，open 函数将正确地指向 k6 提供的全局文件读取功能，从而能够正确加载 data.json 文件并解析其内容，避免 TypeError。
注意事项与最佳实践
- 区分全局函数与模块导入：在使用 k6 API 时，务必查阅官方文档，了解哪些函数是全局可用的（如 open、console.log），哪些需要从特定模块导入（如 http、check、sleep）。
- 错误信息分析：当遇到 TypeError 时，仔细阅读错误堆栈信息。它通常会指出是哪个变量或函数被错误地当作 undefined 处理，从而帮助定位问题。
- 环境配置：确保通过 --env 参数正确传递了 resourseURL 环境变量，并且 data.json 文件路径是正确的。如果文件不存在或路径错误，open() 可能会抛出其他错误，例如文件未找到。
- JSON 格式验证：确保您尝试解析的文件内容确实是有效的 JSON 格式。无效的 JSON 也会导致 JSON.parse() 失败。
总结
TypeError: Value is not an object: undefined 在 k6 脚本中加载外部数据时，通常是由于误解了 open 函数的性质。open 是一个全局可用的函数，不应通过 import 语句引入。理解 k6 API 的设计哲学，特别是区分全局函数和模块导入，是编写健壮、高效 k6 脚本的关键。通过简单的移除不必要的 import {open} from 'k6'; 语句，即可轻松解决这一常见问题，确保您的性能测试顺利进行。
