このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

DOMQuad: toJSON() メソッド

Baseline
広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2020年1月以降、すべてのブラウザーで利用可能です。

メモ: この機能はウェブワーカー内で利用可能です。

toJSON() は DOMQuad インターフェイスのメソッドで、DOMQuad オブジェクトを表す、JSON にシリアライズ可能なプレーンオブジェクトを返します。

このメソッドは、JSON のシリアライズ中に DOMQuad オブジェクトに遭遇すると、JSON.stringify() によって自動的に呼び出されます。シリアライズされた値は、その後 JSON.parse() の復元関数内で DOMQuad.fromQuad() 関数を使用してデシリアライズできます。

構文

js
toJSON()

引数

なし。

返値

次のプロパティを含む、JSON にシリアライズ可能なプレーンオブジェクトです。

各プロパティの値はそのままコピーされます。返されたオブジェクトを JSON.stringify() に渡すと、p1、p2、p3、p4 プロパティはさらに DOMPointReadOnly.toJSON() を使用してシリアライズされます。

例

toJSON() を直接呼び出す

この例では、DOMQuad オブジェクトを作成します。toJSON() を直接呼び出すと、プレーンオブジェクトが返されます。そのプロパティの値は、元のオブジェクトの対応するプロパティの値と同じです。

js
const topLeft = new DOMPoint(window.screenX, window.screenY);
const topRight = new DOMPoint(
  window.screenX + window.innerWidth,
  window.screenY,
);
const bottomLeft = new DOMPoint(
  window.screenX,
  window.screenY + window.innerHeight,
);
const bottomRight = new DOMPoint(
  window.screenX + window.innerWidth,
  window.screenY + window.innerHeight,
);

const quad = new DOMQuad(topLeft, topRight, bottomRight, bottomLeft);

const json = quad.toJSON();
console.log(json); // プレーンオブジェクト
console.log(typeof json); // "object"
console.log(json.p1.x); // quad.p1.x と同じ値

JSON 文字列へのシリアライズ

前の例の DOMQuad オブジェクトは、JSON.stringify() を使用してシリアライズされます。このメソッドは toJSON() メソッドを自動的に呼び出します。

js
const quadJSON = JSON.stringify(quad);
console.log(quadJSON);

画面座標が (0, 0) で、内側の幅が 800、内側の高さが 600 のウィンドウの場合、次のような JSON 文字列がログ出力されます(読みやすさのために整形しています)。

json
{
  "p1": {
    "x": 0,
    "y": 0,
    "z": 0,
    "w": 1
  },
  "p2": {
    "x": 800,
    "y": 0,
    "z": 0,
    "w": 1
  },
  "p3": {
    "x": 800,
    "y": 600,
    "z": 0,
    "w": 1
  },
  "p4": {
    "x": 0,
    "y": 600,
    "z": 0,
    "w": 1
  }
}

仕様書

仕様書
Geometry Interfaces Module Level 1
# dom-domquad-tojson

ブラウザーの互換性