← 返回首页

Uint8Array.prototype.setFromHex() - JavaScript | MDN

Toggle sidebar

Theme

OS default
Light
Dark

日本語

Remember language Learn more

Uint8Array.prototype.setFromHex()

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.

setFromHex() は Uint8Array インスタンスのメソッドで、この Uint8Array オブジェクトを 16 進エンコードされた文字列のバイト列で埋めて、読み込んだバイト数と書き込んだバイト数を示すオブジェクトを返します。

このメソッドは、文字列をバイト配列に解釈します。文字列を単一の数値に変換するには、代わりに parseInt() 関数を、 radix を 16 に設定して使用してください。

In this article

構文

js

setFromHex(string)

引数

string

Uint8Array に書き込むバイト列をエンコードした 16 進文字列。文字列は次の条件を満たす必要があります。

2 文字で 1 バイトをエンコードするため、文字数は偶数である必要があります。
0～9 および A～F （大文字と小文字を区別しない）の 16 進文字のみが含まれている必要があります。
ホワイトスペースが含まれていないこと（Uint8Array.prototype.setFromBase64() とは異なります）。

文字列は、配列が満たされるまでの点までしか読み込まれませんので、その点以降の不正な 16 進構文は無視されます。

返値

次のプロパティが含まれているオブジェクトです。

read

入力文字列から読み込まれた 16 進文字の数。デコードされたデータが配列に収まる場合、これは入力文字列の長さです。そうでない場合、これは配列に収まる完全な 16 進文字の数です。

Uint8Array に書き込まれたバイト数。この Uint8Array の byteLength より大きくなることはありません。

例外

入力文字列に 16 進文字以外の文字が含まれているか、その長さが奇数の場合に発生します。

入力文字列が文字列でない場合に発生します。

例

16 進文字列のデコード

この例では、16 進文字列を既存の Uint8Array にデコードします。

js
const uint8Array = new Uint8Array(8);
const result = uint8Array.setFromHex("cafed00d");
console.log(result); // { read: 8, written: 4 }
console.log(uint8Array); // Uint8Array(8) [202, 254, 208, 13, 0, 0, 0, 0]

長い文字列を小さな配列にデコード

文字列に配列が保持できるデータ量以上のデータが含まれている場合、メソッドは配列が保持できるバイト数だけ書き込みます。

js
const uint8Array = new Uint8Array(4);
const result = uint8Array.setFromHex("cafed00d-some random stuff");
console.log(result); // { read: 8, written: 4 }
console.log(uint8Array); // Uint8Array(4) [202, 254, 208, 13]

余分な文字は、たとえそれが不正な文字であっても無視されます。ただし、入力文字列の合計長は偶数でなければなりません。

特定のオフセットでデータを設定

setFromHex() メソッドは、常に Uint8Array の先頭から書き込みを始めます。配列の途中から書き込む場合は、代わりに TypedArray.prototype.subarray() に書き込むことができます。

js
const uint8Array = new Uint8Array(8);
// オフセット 2 から書き始める
const result = uint8Array.subarray(2).setFromHex("cafed00d");
console.log(result); // { read: 8, written: 4 }
console.log(uint8Array);
// Uint8Array(8) [0, 0, 202, 254, 208, 13, 0, 0]

仕様書

Specification

ECMAScript® 2027 Language Specification
# sec-uint8array.prototype.setfromhex

ブラウザーの互換性

Enable JavaScript to view this browser compatibility table.

関連情報

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 2025年7月19日 by MDN contributors.

View this page on GitHub • Report a problem with this content

標準組み込みオブジェクト
Uint8Array
コンストラクター
1. Uint8Array()
静的メソッド
1. fromBase64()
2. fromHex()
インスタンスメソッド
1. setFromBase64()
2. setFromHex()
3. toBase64()
4. toHex()
継承
TypedArray
静的メソッド
1. from()
2. of()
静的プロパティ
1. BYTES_PER_ELEMENT
2. [Symbol.species]
インスタンスメソッド
1. at()
2. copyWithin()
3. entries()
4. every()
5. fill()
6. filter()
7. find()
8. findIndex()
9. findLast()
10. findLastIndex()
11. forEach()
12. includes()
13. indexOf()
14. join()
15. keys()
16. lastIndexOf()
17. map()
18. reduce()
19. reduceRight()
20. reverse()
21. set()
22. slice()
23. some()
24. sort()
25. subarray()
26. toLocaleString()
27. toReversed()
28. toSorted()
29. toString()
30. values()
31. with()
32. [Symbol.iterator]()
インスタンスプロパティ
1. buffer
2. byteLength
3. byteOffset
4. length
Object/Function
静的メソッド
1. apply()
2. bind()
3. call()
4. toString()
5. [Symbol.hasInstance]()
静的プロパティ
1. displayName
2. length
3. name
4. prototype
5. arguments
6. caller
インスタンスメソッド
1. __defineGetter__()
2. __defineSetter__()
3. __lookupGetter__()
4. __lookupSetter__()
5. hasOwnProperty()
6. isPrototypeOf()
7. propertyIsEnumerable()
8. toLocaleString()
9. toString()
10. valueOf()
インスタンスプロパティ
1. __proto__
2. constructor
関連するページ
BigInt64Array
BigUint64Array
Float16Array
Float32Array
Float64Array
Int8Array
Int16Array
Int32Array
Uint8ClampedArray
Uint16Array
Uint32Array