提供各種輔助方法的模組，提供基本的（依 seed 而定）操作，可用於實作 faker 方法。模組概覽#
一個特別實用的方法是 {{$helpers.arrayElement(['abc','123'])}}，它會從陣列中回傳一個隨機元素。這在新增 Faker 未包含的自訂資料時非常有用。有多個方法可以根據各種模式產生字串：{{$helpers.replaceSymbols('##??**')}} 和 {{$helpers.fromRegExp('[A-Z0-9]{4}-[A-Z0-9]{4}')}} 。
arrayElement#
| 名稱 | 類型 | 預設值 | 說明 |
|---|
| array | T[] | | 要從中選取值的陣列。 |
arrayElements#
| 名稱 | 類型 | 預設值 | 說明 |
|---|
| array | T[] | | 要從中選取值的陣列。 |
| max | number | | 要選取的最大元素數量。 |
| min | number | | 要選取的最小元素數量。 |
fromRegExp#
此函式並不完整支援實際的 RegExp。不支援分組、錨點和字元類別等功能。如果你正在尋找可根據 RegExp 隨機產生字串的函式庫，請參閱 randexp.jsx{times} => 將 x 精確重複 times 次。
x{min,max} => 將 x 重複 min 到 max 次。
[x-y] => 隨機取得 x 到 y 之間的字元（含端點）。
[x-y]{times} => 隨機取得 x 到 y 之間的字元（含端點）並重複 times 次。
[x-y]{min,max} => 隨機取得 x 到 y 之間的字元（含端點）並重複 min 到 max 次。
[^...] => 隨機取得不在指定範圍內的 ASCII 數字或字母字元。（例如 [^0-9] 會取得隨機的非數字字元）。
[-...] => 在範圍中包含連字號。若使用，必須放在否定字元 ^ 之後、任何字元集之前（例如 [^-0-9] 不會取得任何數字字元或連字號）。
/[x-y]/i => 隨機取得 x 到 y 之間的大寫或小寫字元（含端點）。
[x-y]? => 隨機決定是否包含 x 到 y 之間的字元（含端點）。
[x-y]* => 將 x 到 y 之間的字元（含端點）重複 0 次或更多次。
[x-y]+ => 將 x 到 y 之間的字元（含端點）重複 1 次或更多次。
. => 回傳萬用 ASCII 字元，可以是任何數字、字元或符號。也可以與量詞組合使用。
| 名稱 | 類型 | 預設值 | 說明 |
|---|
| pattern | string | RegExp | | 要為其產生相符字串的範本字串/RegExp。 |
拋出：如果量詞中的 min 值大於 max 值，例如 #{10,5}。如果傳入無效的量詞符號。
rangeToNumber#
| 名稱 | 類型 | 預設值 | 說明 |
|---|
| max | number | | 範圍的最大值。 |
| min | number | | 範圍的最小值。 |
replaceCreditCardSymbols#
取代信用卡結構描述中的符號和模式，包括 Luhn 校驗碼。| 名稱 | 類型 | 預設值 | 說明 |
|---|
| string | string | '6453-####-####-####-###L' | 信用卡格式模式。 |
| symbol | string | '#' | 要取代為數字的符號。 |
replaceSymbols#
| 名稱 | 類型 | 預設值 | 說明 |
|---|
| string | string | | 要解析的範本 字串。 |
slugify#
將指定字串 slugify。為此，所有空格（ ）都會被替換為連字號（-），並且大多數非單字字元（點號和連字號除外）都會被移除。| 名稱 | 類型 | 預設值 | 說明 |
|---|
| string | string | | 要 slugify 的輸入。 |
Modified at 2026-06-11 10:26:02
