Uint8Array.fromHex()

Baseline 2025
Newly available

Since September 2025, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Phương thức tĩnh Uint8Array.fromHex() tạo một đối tượng Uint8Array mới từ một chuỗi thập lục phân.

Phương thức này phân tích chuỗi thành một mảng byte. Để chuyển đổi chuỗi thành một số duy nhất, hãy dùng hàm parseInt() với radix16 thay thế.

Cú pháp

js
Uint8Array.fromHex(string)

Tham số

string

Một chuỗi thập lục phân mã hóa các byte cần chuyển đổi thành Uint8Array. Chuỗi phải:

  • Có số ký tự chẵn vì hai ký tự mã hóa một byte.
  • Chỉ chứa các ký tự trong bảng chữ cái thập lục phân, bao gồm 0–9 và A–F (không phân biệt hoa thường).
  • Không chứa khoảng trắng (khác với Uint8Array.prototype.setFromBase64()).

Giá trị trả về

Một đối tượng Uint8Array mới chứa các byte đã được giải mã từ chuỗi thập lục phân.

Ngoại lệ

SyntaxError

Ném ra nếu chuỗi đầu vào chứa các ký tự ngoài bảng chữ cái hex, hoặc độ dài của nó là số lẻ.

TypeError

Ném ra nếu chuỗi đầu vào không phải là chuỗi.

Ví dụ

Giải mã một chuỗi thập lục phân

Ví dụ này giải mã một chuỗi thập lục phân thành Uint8Array.

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

Các ký tự viết hoa cũng được hỗ trợ:

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

Đặc tả

Specification
ECMAScript® 2027 Language Specification
# sec-uint8array.fromhex

Tương thích trình duyệt

Xem thêm