Uint8Array.fromHex()

基準線 2025
新推出

自 ⁨2025 年 9 月⁩起,此功能適用於最新裝置和瀏覽器版本。此功能可能不適用於較舊的裝置或瀏覽器。

Uint8Array.fromHex() 靜態方法根據十六進位制字串建立新的 Uint8Array 物件。

此方法會將字串解析為位元組陣列。要將字串轉換為單個數字,請改用帶有 radix 設定為 16parseInt() 函式。

語法

js
Uint8Array.fromHex(string)

引數

string

用於編碼要轉換為 Uint8Array 的位元組的十六進位制字串。該字串必須

  • 具有偶數個字元,因為兩個字元編碼一個位元組。
  • 僅包含十六進位制字母表中的字元,包括 0–9 和 A–F(不區分大小寫)。
  • 不包含空格(與 Uint8Array.prototype.setFromBase64() 不同)。

返回值

一個包含從十六進位制字串解碼出的位元組的新 Uint8Array 物件。

異常

SyntaxError

如果輸入字串包含十六進位制字母表之外的字元,或其長度為奇數,則會丟擲此錯誤。

TypeError

如果輸入字串不是字串,則會丟擲此錯誤。

示例

解碼十六進位制字串

此示例將十六進位制字串解碼為 Uint8Array

js
const hexString = "cafed00d";
const bytes = Uint8Array.fromHex(hexString);
console.log(bytes); // Uint8Array [ 202, 254, 208, 13 ]

也支援大寫字元

js
const hexString = "CAFEd00d";
const bytes = Uint8Array.fromHex(hexString);
console.log(bytes); // Uint8Array [ 202, 254, 208, 13 ]

規範

規範
Uint8Array 與 base64 的相互轉換
# sec-uint8array.fromhex

瀏覽器相容性

另見