本文旨在解決 k6 性能測試腳本中加載本地 JSON 文件時(shí)常見的 `SyntaxError`。當(dāng)嘗試使用 Node.js 的 `require()` 語法導(dǎo)入 JSON 數(shù)據(jù)時(shí)，k6 的 Goja JavaScript 運(yùn)行時(shí)會(huì)報(bào)錯(cuò)。正確的做法是利用 k6 內(nèi)置的 `open()` 函數(shù)在初始化階段安全有效地讀取本地文件，從而確保測試腳本的順利執(zhí)行和數(shù)據(jù)的有效利用。

在進(jìn)行性能測試時(shí)，我們經(jīng)常需要從外部文件加載數(shù)據(jù)，例如 API 端點(diǎn)、用戶憑證或請求體等。對(duì)于 k6 腳本而言，加載本地 JSON 文件是一種常見的需求。然而，不正確的數(shù)據(jù)加載方式可能會(huì)導(dǎo)致腳本執(zhí)行失敗，其中最典型的錯(cuò)誤便是 SyntaxError: Unexpected Token, expected ;。

理解 k6 的 JavaScript 運(yùn)行時(shí)環(huán)境

k6 使用 Goja 作為其 JavaScript 引擎，這是一個(gè)用 Go 語言實(shí)現(xiàn)的 JavaScript 運(yùn)行時(shí)。與 Node.js 不同，Goja 并不原生支持 Node.js 的模塊系統(tǒng)，包括 require() 函數(shù)。因此，當(dāng)您嘗試在 k6 腳本中使用 require('./data.json') 這樣的語法時(shí)，k6 無法正確解析該語句，并將其視為語法錯(cuò)誤，通常會(huì)指向 JSON 文件內(nèi)容的開頭。

錯(cuò)誤的加載方式示例

考慮以下 k6 腳本和 data.json 文件：

data.json:

{
  "base_url": "https://gorest.co.in/public/v2/users"
}

k6 腳本 (錯(cuò)誤示例):

import http from 'k6/http';
import { check, sleep } from 'k6';

// 錯(cuò)誤的加載方式，會(huì)導(dǎo)致 SyntaxError
const dataset = JSON.parse(JSON.stringify(require("./data.json")));

export let options = {
  vus: 10,
  duration: '1m',
};

export default function () {
  let response = http.get(dataset.base_url);
  check(response, { 'Status is 200': (r) => r.status === 200 });
  sleep(1);
}

當(dāng)執(zhí)行上述腳本時(shí)，您會(huì)遇到類似以下的錯(cuò)誤信息：

SyntaxError: Getting Unexpected Token, expected ;

錯(cuò)誤通常會(huì)指向 data.json 文件的第一個(gè)字符，這正是因?yàn)?k6 運(yùn)行時(shí)無法識(shí)別 require 語句。

正確的解決方案：使用 open() 函數(shù)

k6 提供了一個(gè)內(nèi)置的 open() 函數(shù)，用于在腳本的初始化（init）階段讀取本地文件。open() 函數(shù)會(huì)返回文件的內(nèi)容作為字符串，然后您可以將其解析為 JSON 對(duì)象。

Find JSON Path Online

Easily find JSON paths within JSON objects using our intuitive Json Path Finder

30

查看詳情

k6 腳本 (正確示例):

import http from 'k6/http';
import { check, sleep } from 'k6';

// 使用 k6 的 open() 函數(shù)正確加載本地 JSON 文件
const dataset = JSON.parse(open('./data.json'));

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

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

    // 斷言響應(yīng)狀態(tài)碼為 200
    check(response, { 'Status is 200': (r) => r.status === 200 });

    // 在下一次迭代前暫停 1 秒
    sleep(1);
}

open() 函數(shù)詳解：

• 用途： open(filePath) 函數(shù)用于讀取指定路徑的本地文件內(nèi)容。
• 返回類型： 它返回文件內(nèi)容的字符串表示。
• 執(zhí)行上下文： open() 只能在 k6 腳本的初始化階段（即 export const options 和 export default function 之外的頂層作用域）調(diào)用。這是因?yàn)槲募x取操作應(yīng)該在測試開始前完成，以避免在 VUs 運(yùn)行時(shí)重復(fù)讀取文件，影響性能。
• 文件路徑： 路徑可以是相對(duì)路徑（相對(duì)于 k6 腳本文件）或絕對(duì)路徑。

通過將 require("./data.json") 替換為 open('./data.json')，我們利用了 k6 自身提供的文件讀取機(jī)制，從而避免了 SyntaxError 并成功加載了數(shù)據(jù)。

高級(jí)數(shù)據(jù)加載策略

對(duì)于更復(fù)雜或更龐大的數(shù)據(jù)集，k6 提供了更高效的數(shù)據(jù)加載和管理方式：

1. 使用 SharedArray 處理大型數(shù)據(jù)集

如果您的 data.json 文件非常大，或者包含需要被所有虛擬用戶（VUs）共享的復(fù)雜數(shù)據(jù)結(jié)構(gòu)，推薦使用 SharedArray。SharedArray 允許您將數(shù)據(jù)加載一次，并在所有 VUs 之間高效共享，避免了每個(gè) VU 獨(dú)立加載數(shù)據(jù)的開銷。

SharedArray 示例:

import { SharedArray } from 'k6/data';

const rawData = open('./large_data.json');
const mySharedData = new SharedArray('my data', function () {
  return JSON.parse(rawData);
});

export default function () {
  // 在這里使用 mySharedData
  const item = mySharedData[Math.floor(Math.random() * mySharedData.length)];
  // ...
}

2. 數(shù)據(jù)參數(shù)化

數(shù)據(jù)參數(shù)化是性能測試中的一個(gè)核心概念，它允許您使用不同的輸入數(shù)據(jù)來模擬真實(shí)用戶行為。除了簡單的 JSON 文件，k6 還支持從 CSV 文件或其他自定義數(shù)據(jù)源加載數(shù)據(jù)。結(jié)合 SharedArray，您可以實(shí)現(xiàn)靈活且高效的數(shù)據(jù)驅(qū)動(dòng)測試。

總結(jié)

在 k6 性能測試腳本中加載本地 JSON 文件時(shí)，務(wù)必記住 k6 的 JavaScript 運(yùn)行時(shí)與 Node.js 環(huán)境有所不同。避免使用 require()，而應(yīng)采用 k6 提供的 open() 函數(shù)來讀取文件內(nèi)容，并結(jié)合 JSON.parse() 進(jìn)行解析。對(duì)于大型或復(fù)雜的數(shù)據(jù)集，SharedArray 提供了更優(yōu)的性能和管理方式。理解并正確運(yùn)用這些數(shù)據(jù)加載機(jī)制，是編寫高效、穩(wěn)定的 k6 性能測試腳本的關(guān)鍵。

以上就是k6 腳本中正確加載本地 JSON 數(shù)據(jù)：避免 SyntaxError的詳細(xì)內(nèi)容，更多請關(guān)注php中文網(wǎng)其它相關(guān)文章！