【Node.js24.x】Object::isRawJSON()メソッドの使い方

isRawJSONメソッドは、引数として与えられた値が、Node.jsのV8 JavaScriptエンジンが内部的に扱う「Raw JSON」という特殊なオブジェクトであるかを判定するために実行するメソッドです。

通常、JSON文字列をJavaScriptオブジェクトに変換するJSON.parse()などの関数は、標準的なオブジェクトを生成します。しかし、Node.jsバージョン24以降のV8エンジンでは、パフォーマンス最適化のため、元のJSON文字列への参照を保持する特殊な内部表現を持つオブジェクトが生成されることがあります。これを「Raw JSON」と呼びます。

isRawJSONメソッドは、このようなRaw JSONオブジェクトを識別することを目的としています。開発者はこのメソッドにより、受け取ったデータが通常のJavaScriptオブジェクトか、V8エンジンが特別に扱うRaw JSONかを判別できます。これにより、Raw JSONデータに対し、より効率的な処理を施したり、特定の内部的な挙動を考慮したプログラミングが可能になります。引数がRaw JSONであればtrueを、そうでなければfalseを返します。

Copy
1console.log(Object.isRawJSON('"hello"'));
2console.log(Object.isRawJSON('123'));
3console.log(Object.isRawJSON('true'));
4console.log(Object.isRawJSON('null'));
5console.log(Object.isRawJSON('[1, 2]'));
6console.log(Object.isRawJSON('{"key": "value"}'));
7console.log(Object.isRawJSON('not a json string'));
8console.log(Object.isRawJSON(123));
9console.log(Object.isRawJSON(true));

引数なし

引数はありません

戻り値なし

戻り値はありません