本教程旨在解決 k6 性能測試腳本中常見的 `typeerror: value is not an object: undefined` 錯誤。該錯誤通常源于錯誤地嘗試導(dǎo)入 k6 的 `open` 函數(shù)。`open` 是 k6 初始化上下文中的全局函數(shù)，無需顯式導(dǎo)入。文章將詳細解釋錯誤原因，并提供正確的腳本編寫方式，確保外部數(shù)據(jù)文件能被正確加載，從而順利執(zhí)行性能測試。

在進行 k6 性能測試時，我們經(jīng)常需要從外部文件加載配置或測試數(shù)據(jù)，例如 API 基地址、用戶憑證等。k6 提供了 open() 函數(shù)來讀取本地文件。然而，不恰當(dāng)?shù)氖褂梅绞?，尤其是嘗試像導(dǎo)入模塊一樣導(dǎo)入 open 函數(shù)，可能會導(dǎo)致運行時出現(xiàn) TypeError: Value is not an object: undefined 錯誤。本文將深入分析這一錯誤的原因，并提供正確的解決方案。

理解 k6 中的 open() 函數(shù)

open() 函數(shù)是 k6 提供的一個內(nèi)置功能，用于在腳本初始化階段（即 init context）讀取本地文件內(nèi)容。它的主要特點是：

1. 全局可用性：open() 函數(shù)在 k6 腳本的初始化上下文中是全局可用的，無需通過 import 語句顯式導(dǎo)入。這與 http、check、sleep 等需要從 k6/http 或 k6 模塊導(dǎo)入的函數(shù)不同。
2. 執(zhí)行時機：open() 只能在腳本的頂層作用域或 init context 中調(diào)用，用于加載那些在整個測試生命周期中保持不變的配置或數(shù)據(jù)。它不能在 default function（VU 函數(shù)）內(nèi)部調(diào)用。
3. 返回值：open() 函數(shù)返回文件內(nèi)容的字符串形式。如果文件是 JSON 格式，通常需要結(jié)合 JSON.parse() 來將其轉(zhuǎn)換為 JavaScript 對象。

TypeError: Value is not an object: undefined 錯誤溯源

當(dāng) k6 腳本中出現(xiàn) TypeError: Value is not an object: undefined 錯誤，并且錯誤指向 JSON.parse(open(__ENV.resourseURL)) 這一行時，其根本原因在于錯誤地嘗試導(dǎo)入 open 函數(shù)。

考慮以下錯誤的腳本片段：

import {open} from 'k6'; // 錯誤：嘗試導(dǎo)入 open 函數(shù)

const jsonData = JSON.parse(open(__ENV.resourseURL));
const baseURL = jsonData.base_url;

在 k6 中，open 函數(shù)本身并不存在于任何可導(dǎo)入的模塊中。當(dāng)您嘗試 import {open} from 'k6'; 時，JavaScript 模塊系統(tǒng)會嘗試從 k6 模塊中解構(gòu)名為 open 的導(dǎo)出。由于 k6 模塊并沒有導(dǎo)出 open，因此 import {open} from 'k6'; 這行代碼實際上會將 open 變量賦值為 undefined。

隨后，當(dāng)執(zhí)行 JSON.parse(open(__ENV.resourseURL)) 時，實際上是在調(diào)用 JSON.parse(undefined(__ENV.resourseURL))。undefined 并不是一個函數(shù)，因此嘗試調(diào)用它會導(dǎo)致 TypeError。更具體地說，由于 open 此時是 undefined，JSON.parse 接收到的參數(shù)就是 undefined，而 JSON.parse 期望的是一個字符串，所以它會拋出 TypeError: Value is not an object: undefined。

解決方案：移除不必要的導(dǎo)入

解決這個 TypeError 的方法非常簡單：移除所有嘗試導(dǎo)入 open 函數(shù)的語句。 由于 open 函數(shù)是全局可用的，您只需直接調(diào)用它即可。

挖錯網(wǎng)

一款支持文本、圖片、視頻糾錯和AIGC檢測的內(nèi)容審核校對平臺。

28

查看詳情

以下是修正后的 k6 腳本示例：

import http from 'k6/http';
import { check, sleep } from 'k6'; // 導(dǎo)入其他必要的模塊和函數(shù)

// 正確的使用方式：open 函數(shù)無需導(dǎo)入，直接調(diào)用即可
const jsonData = JSON.parse(open(__ENV.resourseURL));
const baseURL = jsonData.base_url;

export let options = {
  vus: 10, // 模擬的虛擬用戶數(shù)量
  duration: '1m', // 測試持續(xù)時間
};

export default function () {
  // 發(fā)送 HTTP GET 請求
  let response = http.get(baseURL);

  // 斷言響應(yīng)狀態(tài)碼為 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 函數(shù)將正確地指向 k6 提供的全局文件讀取功能，從而能夠正確加載 data.json 文件并解析其內(nèi)容，避免 TypeError。

注意事項與最佳實踐

1. 區(qū)分全局函數(shù)與模塊導(dǎo)入：在使用 k6 API 時，務(wù)必查閱官方文檔，了解哪些函數(shù)是全局可用的（如 open、console.log），哪些需要從特定模塊導(dǎo)入（如 http、check、sleep）。
2. 錯誤信息分析：當(dāng)遇到 TypeError 時，仔細閱讀錯誤堆棧信息。它通常會指出是哪個變量或函數(shù)被錯誤地當(dāng)作 undefined 處理，從而幫助定位問題。
3. 環(huán)境配置：確保通過 --env 參數(shù)正確傳遞了 resourseURL 環(huán)境變量，并且 data.json 文件路徑是正確的。如果文件不存在或路徑錯誤，open() 可能會拋出其他錯誤，例如文件未找到。
4. JSON 格式驗證：確保您嘗試解析的文件內(nèi)容確實是有效的 JSON 格式。無效的 JSON 也會導(dǎo)致 JSON.parse() 失敗。

總結(jié)

TypeError: Value is not an object: undefined 在 k6 腳本中加載外部數(shù)據(jù)時，通常是由于誤解了 open 函數(shù)的性質(zhì)。open 是一個全局可用的函數(shù)，不應(yīng)通過 import 語句引入。理解 k6 API 的設(shè)計哲學(xué)，特別是區(qū)分全局函數(shù)和模塊導(dǎo)入，是編寫健壯、高效 k6 腳本的關(guān)鍵。通過簡單的移除不必要的 import {open} from 'k6'; 語句，即可輕松解決這一常見問題，確保您的性能測試順利進行。

以上就是k6 性能測試：open 函數(shù)誤導(dǎo)入導(dǎo)致的 TypeError 錯誤分析與修正的詳細內(nèi)容，更多請關(guān)注php中文網(wǎng)其它相關(guān)文章！