recursal/MDN huggingface dataset:
Sensor: activate イベント
=====================

**`activate`** イベントは、センサーの動作が開始したとき発火します。これは、センサーが測定値の取得を開始したということです。

`Sensor` はベースクラスであり、`onactivate` および `activate` イベントは派生クラスからのみ利用可能です。

構文
--

`addEventListener()` のようなメソッドでイベント名を用いるか、イベントハンドラープロパティを設定します。


```js
addEventListener("activate", (event) => {});

onactivate = (event) => {};
```

イベント型
-----

汎用の `Event` であり、追加されたプロパティはありません。

例
-

### 加速度計の測定の準備ができたとき記録する

この例では、`Accelerometer` の動作開始を記録するイベントリスナーを追加します。


```js
const acl = new Accelerometer({ frequency: 60 });
acl.addEventListener("activate", () => console.log("測定の準備ができました。"));
acl.start();
```

仕様書
---

| Specification |
| --- |
| Generic Sensor API # sensor-onactivate |

ブラウザーの互換性
---------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

関連情報
----

* Sensor `error` イベント
* Sensor `reading` イベント
Sensor: activated プロパティ
=======================

`Sensor` インターフェイスの読み取り専用プロパティ **`activated`** は、センサーが作動中かを表す `boolean` 値を返します。

`Sensor` はベースクラスなので、`activated` は派生クラスからのみ読み取り可能です。

値
-

`boolean` 値です。

仕様書
---

| Specification |
| --- |
| Generic Sensor API # sensor-activated |

ブラウザーの互換性
---------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
Sensor: stop() メソッド
===================

`Sensor` インターフェイスの **`stop`** メソッドは、現在のセンサーを動作停止させます。

構文
--


```js
stop()
```

### 引数

なし

### 返値

なし (`undefined`)

例
-


```js
// TBD
```

仕様書
---

| Specification |
| --- |
| Generic Sensor API # sensor-stop |

ブラウザーの互換性
---------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
Sensor: start() メソッド
====================

**`start`** メソッドは、`Sensor` をベースとするセンサーを 1 個動作開始させます。

構文
--


```js
start()
```

### 引数

なし

### 返値

なし (`undefined`)

仕様書
---

| Specification |
| --- |
| Generic Sensor API # sensor-start |

ブラウザーの互換性
---------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
Sensor: error イベント
==================

**`error`** イベントは、センサーで例外が発生したとき発火します。

`Sensor` はベースクラスであり、`onerror` および `error` イベントは派生クラスからのみ利用可能です。

このイベントの発生後、`Sensor` オブジェクトは idle 状態になります。センサーが値を読んでいた場合は、再び開始されるまで停止します。

構文
--

`addEventListener()` のようなメソッドでイベント名を用いるか、イベントハンドラープロパティを設定します。


```js
addEventListener("error", (event) => {});

onerror = (event) => {};
```

イベント型
-----

`Event` から派生した `SensorErrorEvent` です。

Event

SensorErrorEventイベントプロパティ
---------

*以下のプロパティに加え、親インターフェイスの `Event` 由来のプロパティが利用可能です。*

`error` 読取専用 

投げられた `DOMException` を返します。

例
-

### 加速度計の例外を記録する

この例では、`Accelerometer` で発生したエラーを記録するイベントリスナーを追加します。


```js
const acl = new Accelerometer({ frequency: 60 });
acl.addEventListener("error", (error) => console.log(`エラー: ${error.name}`));
acl.start();
```

仕様書
---

| Specification |
| --- |
| Generic Sensor API # sensor-onerror |

ブラウザーの互換性
---------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

関連情報
----

* Sensor `activate` イベント
* Sensor `reading` イベント
Sensor: reading イベント
====================

**`reading`** イベントは、センサーで新しい測定値が得られたとき発火します。

`Sensor` はベースクラスであり、`onreading` および `reading` イベントは派生クラスからのみ利用可能です。

構文
--

`addEventListener()` のようなメソッドでイベント名を用いるか、イベントハンドラープロパティを設定します。


```js
addEventListener("reading", (event) => {});

onreading = (event) => {};
```

イベント型
-----

汎用の `Event` であり、追加されたプロパティはありません。

例
-

### 加速度を取得する

この例では、`Accelerometer` から加速度の値を取得するイベントリスナーを追加します。1 秒に 60 回取得を行います。


```js
const acl = new Accelerometer({ frequency: 60 });
acl.addEventListener("reading", () => {
  console.log(`X 軸方向の加速度 ${acl.x}`);
  console.log(`Y 軸方向の加速度 ${acl.y}`);
  console.log(`Z 軸方向の加速度 ${acl.z}`);
});
acl.start();
```

仕様書
---

| Specification |
| --- |
| Generic Sensor API # sensor-onreading |

ブラウザーの互換性
---------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

関連情報
----

* Sensor `activate` イベント
* Sensor `error` イベント
Sensor: hasReading プロパティ
========================

`Sensor` インターフェイスの読み取り専用プロパティ **`hasReading`** は、センサーが測定値を持っているかを表す `boolean` 値を返します。

`Sensor` はベースクラスなので、`hasReading` は派生クラスからのみ読み取り可能です。

値
-

`boolean` 値です。

仕様書
---

| Specification |
| --- |
| Generic Sensor API # sensor-has-reading |

ブラウザーの互換性
---------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
Sensor: timestamp プロパティ
=======================

`Sensor` インターフェイスの読み取り専用プロパティ **`timestamp`** は、センサーの最新の測定値のタイムスタンプを返します。

`Sensor` はベースクラスなので、`timestamp` は派生クラスからのみ読み取り可能です。

値
-

`DOMHighResTimeStamp` です。

仕様書
---

| Specification |
| --- |
| Generic Sensor API # sensor-timestamp |

ブラウザーの互換性
---------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
IDBVersionChangeEvent.newVersion
================================

`IDBVersionChangeEvent` インターフェイスの読み取り専用プロパティ **`newVersion`** は、データベースの新しいバージョン番号を返します。

**注:** この機能は Web Worker 内で利用可能です

値
-

64 ビットの整数、またはデータベースが削除される場合は `null` です。

例
-

このコードスニペットでは、データベースを開く要求をし、成功した場合と失敗した場合用のハンドラーを用意します。これらのイベントはカスタムの `IDBVersionChangeEvent` インターフェイスによって発火します。動く例全体は、To-do Notifications を参照してください。(動く例を見る)


```js
const note = document.querySelector("ul");

// 我々のデータベースのバージョン 4 を開きましょう
const DBOpenRequest = window.indexedDB.open("toDoList", 4);

// これらの 2 個のイベントハンドラーは、データベースが開かれる時動作します
DBOpenRequest.onerror = (event) => {
  note.innerHTML += "<li>データベースの読み込み中にエラーが発生しました。</li>";
};

DBOpenRequest.onsuccess = (event) => {
  note.innerHTML += "<li>データベースの初期化が完了しました。</li>";

  // データベースを開いた結果を変数 db に格納します。
  // これは後でトランザクションの開始などにたくさん使います。
  const db = DBOpenRequest.result;
};
```

仕様書
---

| Specification |
| --- |
| Indexed Database API 3.0 # dom-idbversionchangeevent-newversion |

ブラウザーの互換性
---------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

関連情報
----

* IndexedDB の使用
* トランザクションの開始: `IDBDatabase`
* トランザクションの使用: `IDBTransaction`
* キーの範囲の設定: `IDBKeyRange`
* データの取得と変更: `IDBObjectStore`
* カーソルの使用: `IDBCursor`
* リファレンス例: To-do Notifications (動く例を見る)
IDBVersionChangeEvent.oldVersion
================================

`IDBVersionChangeEvent` インターフェイスの読み取り専用プロパティ **`oldVersion`** は、データベースの古いバージョンを返します。

開かれたデータベースがまだ存在しないときは、`oldVersion` の値は 0 です。

**注:** この機能は Web Worker 内で利用可能です

値
-

64 ビットの整数です。

例
-


```js
const dbName = "sampleDB";
const dbVersion = 2;
const request = indexedDB.open(dbName, dbVersion);

request.onupgradeneeded = (e) => {
  const db = request.result;
  if (e.oldVersion < 1) {
    db.createObjectStore("store1");
  }

  if (e.oldVersion < 2) {
    db.deleteObjectStore("store1");
    db.createObjectStore("store2");
  }

  // version < 3, 4... について同様に
};
```

仕様書
---

| Specification |
| --- |
| Indexed Database API 3.0 # dom-idbversionchangeevent-oldversion |

ブラウザーの互換性
---------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

関連情報
----

* IndexedDB の使用
* トランザクションの開始: `IDBDatabase`
* トランザクションの使用: `IDBTransaction`
* キーの範囲の設定: `IDBKeyRange`
* データの取得と変更: `IDBObjectStore`
* カーソルの使用: `IDBCursor`
* リファレンス例: To-do Notifications (動く例を見る)
IDBVersionChangeEvent()
=======================

**安全なコンテキスト用:** この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。

**`IDBVersionChangeEvent()`** コンストラクターは、`onupgradeneeded` イベントハンドラーを実行した結果データベースのバージョンが変更されたことを表す、新しい `IDBVersionChangeEvent` オブジェクトを作成します。

構文
--


```js
new IDBVersionChangeEvent(type)
new IDBVersionChangeEvent(type, options)
```

### 引数

`type`

イベントの名前を表す文字列です。大文字と小文字は区別され、ブラウザーは `versionchange`、`success`、`blocked` のいずれかに設定します。

`options` 省略可

オブジェクトです。*`Event()` で定義されているプロパティに加え*、以下のプロパティを持つことができます。

`oldVersion` 省略可

データベースの更新前のバージョンを表す数値です。デフォルト値は `0` です。

`newVersion` 省略可

データベースの新しいバージョンを表す `unsigned long` 値、もしくはデータベースが削除される場合は `null` です。デフォルト値は `null` です。


### 返値

新しい `IDBVersionChangeEvent` オブジェクトを返します。

例
-

動作する例全体は、To-do Notifications アプリケーションを参照してください。(動く例を見る)

仕様書
---

| Specification |
| --- |
| Indexed Database API 3.0 # dom-idbversionchangeevent-idbversionchangeevent |

ブラウザーの互換性
---------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
MutationEvent: attrName プロパティ
=============================

**非推奨:** この機能は非推奨になりました。まだ対応しているブラウザーがあるかもしれませんが、すでに関連するウェブ標準から削除されているか、削除の手続き中であるか、互換性のためだけに残されている可能性があります。使用を避け、できれば既存のコードは更新してください。このページの下部にある互換性一覧表を見て判断してください。この機能は突然動作しなくなる可能性があることに注意してください。

**`attrName`** は `MutationEvent` インターフェイスの読み取り専用プロパティで、 `DOMAttrModified` イベントの影響を受けるノードの名前を文字列で返します。これは他のイベントでは意味を持たず、空文字列 (`""`) に設定されます。

値
-

文字列です。

例
-


```js
element.addEventListener(
  "DOMAttrModified",
  (event) => {
    console.log(event.attrName);
  },
  false,
);
```

仕様書
---

| Specification |
| --- |
| UI Events # dom-mutationevent-attrname |

ブラウザーの互換性
---------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
MutationEvent: newValue プロパティ
=============================

**非推奨:** この機能は非推奨になりました。まだ対応しているブラウザーがあるかもしれませんが、すでに関連するウェブ標準から削除されているか、削除の手続き中であるか、互換性のためだけに残されている可能性があります。使用を避け、できれば既存のコードは更新してください。このページの下部にある互換性一覧表を見て判断してください。この機能は突然動作しなくなる可能性があることに注意してください。

**`newValue`** は `MutationEvent` インターフェイスの読み取り専用プロパティで、文字列を返します。 `DOMAttrModified` イベントでは、 `Attr` ノードの新しい値を表します。 `DOMCharacterDataModified` イベントでは、`CharacterData` ノードの新しい値を表します。それ以外の場合は、空文字列 (`""`) を返します。

値
-

文字列です。

例
-


```js
element.addEventListener(
  "DOMAttrModified",
  (event) => {
    console.log(event.newValue);
  },
  false,
);
```

仕様書
---

| Specification |
| --- |
| UI Events # dom-mutationevent-newvalue |

ブラウザーの互換性
---------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
MutationEvent: attrChange プロパティ
===============================

**非推奨:** この機能は非推奨になりました。まだ対応しているブラウザーがあるかもしれませんが、すでに関連するウェブ標準から削除されているか、削除の手続き中であるか、互換性のためだけに残されている可能性があります。使用を避け、できれば既存のコードは更新してください。このページの下部にある互換性一覧表を見て判断してください。この機能は突然動作しなくなる可能性があることに注意してください。

**`attrChange`** は `MutationEvent` インターフェイスの読み取り専用プロパティで、 `DOMAttrModified` イベントのトリガーとなった変更の種類を示す数値を返します。取り得る値は `MODIFICATION` (`1`)、`ADDITION` (`2`)、`REMOVAL`(`3`) の 3 つです。この値は他のイベントでは意味を持たず、`0` に設定されます。

値
-

整数です。 `0`、`1` (`MODIFICATION`)、`2` (`ADDITION`)、`3` (`REMOVAL`) のいずれかです。

例
-


```js
element.addEventListener(
  "DOMAttrModified",
  (event) => {
    console.log(event.attrChange);
  },
  false,
);
```

仕様書
---

| Specification |
| --- |
| UI Events # dom-mutationevent-attrchange |

ブラウザーの互換性
---------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
MutationEvent: prevValue プロパティ
==============================

**非推奨:** この機能は非推奨になりました。まだ対応しているブラウザーがあるかもしれませんが、すでに関連するウェブ標準から削除されているか、削除の手続き中であるか、互換性のためだけに残されている可能性があります。使用を避け、できれば既存のコードは更新してください。このページの下部にある互換性一覧表を見て判断してください。この機能は突然動作しなくなる可能性があることに注意してください。

**`prevValue`** は `MutationEvent` インターフェイスの読み取り専用プロパティで、文字列を返します。 `DOMAttrModified` イベントでは、 `Attr` ノードの以前の値を表します。 `DOMCharacterDataModified` イベントでは、 `CharacterData` ノードの以前の値を表します。それ以外の場合は、空文字列 (`""`) を返します。

値
-

文字列です。

例
-


```js
element.addEventListener(
  "DOMAttrModified",
  (event) => {
    console.log(event.previousValue);
  },
  false,
);
```

仕様書
---

| Specification |
| --- |
| UI Events # dom-mutationevent-prevvalue |

ブラウザーの互換性
---------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
MutationEvent: initMutationEvent() メソッド
=======================================

**非推奨:** この機能は非推奨になりました。まだ対応しているブラウザーがあるかもしれませんが、すでに関連するウェブ標準から削除されているか、削除の手続き中であるか、互換性のためだけに残されている可能性があります。使用を避け、できれば既存のコードは更新してください。このページの下部にある互換性一覧表を見て判断してください。この機能は突然動作しなくなる可能性があることに注意してください。

**`initMutationEvent()`** は `MutationEvent` インターフェイスのメソッドで、一度作成された変異イベントの値を初期化します（通常は `Document.createEvent()` メソッドを使用します）。

このメソッドは、 `EventTarget.dispatchEvent()` を使用して、配信される前にイベントを設定するために呼び出される必要があります。

**メモ:** 一般に、これらのイベントを自分で作成することはなく、ブラウザーが作成します。

構文
--


```js
initMutationEvent(type, canBubble, cancelable, relatedNode,
                  prevValue, newValue, attrName, attrChange)
```

### 引数

`type`

 イベントの `type` に設定する文字列。ブラウザーは `MutationEvent` に次の値を設定します。
 `DOMAttrModified`, `DOMAttributeNameChanged`, `DOMCharacterDataModified`, `DOMElementNameChanged`, `DOMNodeInserted`, `DOMNodeInsertedIntoDocument`, `DOMNodeRemoved`, `DOMNodeRemovedFromDocument`,`DOMSubtreeModified`

`canBubble`

論理値で、イベントがバブリングするかどうかを示します。 `Event.bubbles` の値を設定します。

`cancelable`

論理値で、イベントの既定のアクションを阻止できるかどうかを示します。 `Event.cancelable` の値を設定します。

`relatedNode`

文字列で、変更するノードの新しい値を表します。 `MutationEvent.relatedNode` の値を設定します。

`prevValue`

文字列で、変更するノードの前回値を表します。 `MutationEvent.prevValue` の値を設定します。

`newValue`

文字列で、変更するノードの新しい値を表します。 `MutationEvent.newValue` の値を設定します。

`attrName`

文字列で、もしあれば、変更された `Attr` ノードの名前を表します。 `MutationEvent.attrName` の値を設定します。

`attrChange`

整数で、属性ノードが変更された理由を表します。 `MutationEvent.attrChange` の値を設定します。

### 返値

なし (`undefined`)。

仕様書
---

| Specification |
| --- |
| UI Events # dom-mutationevent-initmutationevent |

ブラウザーの互換性
---------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
MutationEvent: relatedNode プロパティ
================================

**非推奨:** この機能は非推奨になりました。まだ対応しているブラウザーがあるかもしれませんが、すでに関連するウェブ標準から削除されているか、削除の手続き中であるか、互換性のためだけに残されている可能性があります。使用を避け、できれば既存のコードは更新してください。このページの下部にある互換性一覧表を見て判断してください。この機能は突然動作しなくなる可能性があることに注意してください。

**`relatedNode`** は `MutationEvent` インターフェイスの読み取り専用プロパティで、 `DOMSubtreeModified` のサブツリー内の変更されたノードのように、イベントに関連するノードを示す文字列を返します。

値
-

文字列です。

例
-


```js
element.addEventListener(
  "DOMSubtreeModified",
  (event) => {
    console.log(event.relatedNode);
  },
  false,
);
```

仕様書
---

| Specification |
| --- |
| UI Events # dom-mutationevent-relatednode |

ブラウザーの互換性
---------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
DOMPointReadOnly: DOMPointReadOnly() コンストラクター
=============================================

**`DOMPointReadOnly()`** コンストラクターは、スクリプトコードによってその値を変更できない、 2D または 3D の点を表す新しい `DOMPointReadOnly` オブジェクト（オプションで遠近法を使用可能）を返します。

構文
--


```js
new DOMPointReadOnly()
new DOMPointReadOnly(x)
new DOMPointReadOnly(x, y)
new DOMPointReadOnly(x, y, z)
new DOMPointReadOnly(x, y, z, w)
```

### 引数

`x` 省略可

水平座標 x の値を浮動小数点数で指定します。既定値は 0 です。

`y` 省略可

垂直座標 y の値を浮動小数点数で指定します。既定値は 0 です。

`z` 省略可

奥行き座標 z の値を浮動小数点数で指定します。既定値は 0 です。

`w` 省略可

視点位置 w を浮動小数点数で指定します。既定値は 1 です。


**メモ:** これらの値はそれぞれ*無制限*の数と呼ばれるものです。有限の浮動小数点数に加えて、±`Infinity` や `NaN` のような特別な値も使用することができます。

### 返値

空間内の指定された位置を表す、新しい `DOMPointReadOnly` オブジェクト。

例
-

次のコードは、 2D または 3D の点を作成する例です。


```js
const point2D = new DOMPointReadOnly(50, 25);
const point3D = new DOMPointReadOnly(50, 0, 10);
const perspectivePoint3D = new DOMPointReadOnly(50, 50, 25, 0.5);
```

仕様書
---

| Specification |
| --- |
| Geometry Interfaces Module Level 1 # dom-dompointreadonly-dompointreadonly |

ブラウザーの互換性
---------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
DOMPointReadOnly.fromPoint()
============================

静的な **{domxref("DOMPointReadOnly")}}** メソッド `fromPoint()` は、指定された元の点から新しい `DOMPointReadOnly` オブジェクトを作成し、それを返します。

また、 `new DOMPointReadOnly()` コンストラクターを使用しても、新しい `DOMPointReadOnly` オブジェクトを作成することができます。

構文
--


```js
fromPoint(sourcePoint);
```

### 引数

`sourcePoint`

新しい点のプロパティの値を取得するための `DOMPoint` または `DOMPointReadOnly` インスタンス、あるいは以下のプロパティを含むオブジェクトです。

`x`

空間上の点の `x` 座標を表す、無制限の浮動小数点数。これは一般に水平座標であり、正の値は右側に、負の値は左側になります。既定値は `0` です。

`y`

点の `y` 座標を表す無制限の浮動小数点数。これは垂直座標であり、座標系に適用される変換を除いて、正の値は下向きに、負の値は画面上方に向かって上向きになります。既定値は `0` です。

`z`

点の `z` 座標を与える無制限の浮動小数点数．この座標は、（状況を変えるような変換がないと仮定して）奥行き座標です。正の値はユーザーに近く、負の値は画面の奥に引っ込みます。既定値は `0` です。

`w`

点の `w` 視点位置。無制限の浮動小数点数で与えられます。 既定値は `1` です。


### 返値

新しい（元の点と同じ） `DOMPointReadOnly` オブジェクト。

例
-

### 二次元の点の作成

このサンプルでは、 `x` と `y` に使用する値を含むインラインオブジェクトを指定し、二次元点を作成しています。 `z` と `w` プロパティは既定値（それぞれ `0` と `1`）のままにしておくことが可能です。


```js
const point2D = DOMPointReadOnly.fromPoint({ x: 25, y: 25 });
```

### 既存の点を使用して三次元の点を作成します

この例では、 `DOMPoint` を用いて、 `new DOMPoint()` 型の点 `origPoint` を作成しています。そして、その点は `fromPoint()` の入力として使用され、新しい点 `newPoint` を作成します。


```js
const origPoint = new DOMPoint(25, 25, 100, 0.5);

const newPoint = DOMPointReadOnly.fromPoint(origPoint);
```

仕様書
---

| Specification |
| --- |
| Geometry Interfaces Module Level 1 # dom-dompointreadonly-frompoint |

ブラウザーの互換性
---------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
DOMPointReadOnly: x プロパティ
=========================

**`DOMPointReadOnly`** インターフェイスの **`x`** プロパティは、この点の水平座標 x を保持します。これは、空間内の読み取り専用の点です。このプロパティは、 `DOMPoint` オブジェクトの読み取り専用版なので、 JavaScript コードでは変更することができません。

一般的に、正の値 `x` は右方向を意味し、負の値 `x` は左方向を意味します。これは、変換によって反転された結果がないとみなされます。

値
-

点の x 座標の値を示す倍精度浮動小数点値。この値は**無制限**であり、無限または無効であることが許されます（つまり、その値は `NaN` または `±Infinity` であってもかまいません）。

仕様書
---

| Specification |
| --- |
| Geometry Interfaces Module Level 1 # dom-dompointreadonly-x |

ブラウザーの互換性
---------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

関連情報
----

* その他の座標プロパティ: `y`,
 `z`, および視点位置である
 `w`
DOMPointReadOnly.toJSON()
=========================

メソッド `toJSON()` は、この点オブジェクトの JSON 形式を表すオブジェクトを返します。

構文
--


```js
toJSON();
```

### 引数

なし。

### 返値

プロパティに、メソッドが呼び出された `DOMPoint` または `DOMPointReadOnly` の値が設定された新しいオブジェクトを返します。

例
-

この例では、現在のウィンドウの左上隅をスクリーン座標で表す `DOMPoint` オブジェクトを作成し、それを JSON に変換しています。


```js
var topLeft = new DOMPoint(window.screenX, window.screenY);

var pointJSON = topLeft.toJSON();
```

仕様書
---

| Specification |
| --- |
| Geometry Interfaces Module Level 1 # dom-dompointreadonly-tojson |

ブラウザーの互換性
---------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
DOMPointReadOnly: y プロパティ
=========================

**`DOMPointReadOnly`** インターフェイスの **`y`** プロパティは、空間の読み取り専用の点における垂直座標 y を保持します。

もし、スクリプトでこのプロパティの値を変更する必要がある場合は、代わりに `DOMPoint` オブジェクトを使用 してください。

一般的に、変換によって反転していないとみなすならば、正の値の `y` は下方向を意味し、負の値の `y` は上方向を意味します。

値
-

この点の y 座標の値を示す倍精度浮動小数点値。この値は**無制限**であり、無限大または無効であることが許されます（つまり、その値は `NaN` または `±Infinity` である可能性があります）。

仕様書
---

| Specification |
| --- |
| Geometry Interfaces Module Level 1 # dom-dompointreadonly-y |

ブラウザーの互換性
---------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

関連情報
----

* その他の座標プロパティ: `x`,
 `z`, および視点位置である `w`
DOMPointReadOnly: w プロパティ
=========================

**`DOMPointReadOnly`** インターフェイスの **`w`** プロパティは、この点の視点位置である `w` を保持します。これは空間内の読み取り専用の点です。

スクリプトでこのプロパティの値を変更できるようにする必要がある場合は、代わりに `DOMPoint` オブジェクトを使用する必要があります。

値
-

この点の `w` 視点位置 を示す倍精度浮動小数点値です。この値は**無制限**であり，無限大でも無効値でも構いません（つまり，その値は `NaN` または `±Infinity` であってもかまいません）。既定値は `1.0` である。

仕様書
---

| Specification |
| --- |
| Geometry Interfaces Module Level 1 # dom-dompointreadonly-w |

ブラウザーの互換性
---------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

関連情報
----

* その他の座標プロパティ: `x`, `y`, and `z`
DOMPointReadOnly: z プロパティ
=========================

**`DOMPointReadOnly`** インターフェイスの **`z`** プロパティは、空間の読み取り専用の点における置く息座標 z を保持します。

もし、スクリプトでこのプロパティの値を変更する必要がある場合は、代わりに `DOMPoint` オブジェクトを使用 してください。

一般に、変換によって反転していないとみなされる場合、 `z` の正の値はユーザーに向かい（画面の外側に向かい）、 `z` の負の値はユーザーから離れる（画面の内側へ向かう）ことを意味します。

値
-

この点の z 座標の値を示す倍精度浮動小数点値。この値は**無制限**であり、無限大または無効であることが許されます（つまり、その値は `NaN` または `±Infinity` である可能性があります）。

仕様書
---

| Specification |
| --- |
| Geometry Interfaces Module Level 1 # dom-dompointreadonly-z |

ブラウザーの互換性
---------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

関連情報
----

* その他の座標プロパティ: `x`,
 `y`, および視点位置である `w`
BackgroundFetchUpdateUIEvent.updateUI()
=======================================

Limited availability
--------------------

This feature is not Baseline because it does not work in some of the most widely-used browsers.

* Learn more
* See full compatibility
* Report feedback
**Experimental:** **これは実験的な機能です。**  
本番で使用する前にブラウザー互換性一覧表をチェックしてください。

`BackgroundFetchUpdateUIEvent` インターフェイスの **`updateUI()`** メソッドは、 UI 上のタイトルとアイコンを更新し、バックグラウンドのフェッチの成否を表示します。

このメソッドは一度だけ実行され、フェッチの成否をユーザーに通知することができます。

構文
--


```js
updateUI(options)
```

### 引数

`options` 省略可

下記のいずれかを含むオブジェクト。

`icons` 省略可

UI で用いるアイコンを含む、 1 枚以上の画像リソースのリストです。画像リソースは下記の情報を持つオブジェクトです。

`src`

画像のURL文字列。

`sizes` 省略可

`<link>` `sizes` 属性と同じ意味を持つ文字列。

`type` 省略可

画像の MIME タイプを含む文字列。

`label` 省略可

画像の名前を指定する文字列。


`title` 省略可

UI の新しいタイトルを指定する文字列。


### 返値

`Promise` 。

### 例外

`InvalidStateError` `DOMException`

以下のいずれかに当てはまるとき、発生します。

* `isTrusted` プロパティが `false` のとき。
* `BackgroundFetchUpdateUIEvent` UI 更新のフラグがすでにセットされている、すなわち、すでに `updateUI()` メソッドが呼ばれたあとであるとき。
* `BackgroundFetchUpdateUIEvent` がアクティブではないとき。

例
-

以下の例では、フェッチ成功時に UI のタイトルとアイコン画像を更新しています。


```js
addEventListener("backgroundfetchsuccess", (event) => {
  event.updateUI({
    title: "Episode 5 ready to listen!",
    icon: {
      src: "path/to/success.ico",
      sizes: "16x16 32x32 64x64",
    },
  });
});
```

仕様書
---

| Specification |
| --- |
| Background Fetch # background-fetch-update-ui-event-update-ui |

ブラウザーの互換性
---------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
BackgroundFetchUpdateUIEvent()
==============================

Limited availability
--------------------

This feature is not Baseline because it does not work in some of the most widely-used browsers.

* Learn more
* See full compatibility
* Report feedback
**Experimental:** **これは実験的な機能です。**  
本番で使用する前にブラウザー互換性一覧表をチェックしてください。

コンストラクター **`BackgroundFetchUpdateUIEvent()`** は新しく `BackgroundFetchUpdateUIEvent` オブジェクトを生成します。 このコンストラクターは通常、使用されることはありません。なぜなら、これらのオブジェクトはブラウザーによって自動で生成され、バックグラウンドのフェッチイベントのコールバックに渡されるからです。

構文
--


```js
new BackgroundFetchEvent(type, options)
```

### 引数

`type`

 イベント名の文字列。
 大文字と小文字は区別されます。ブラウザーはこれを `backgroundfetchsuccess` または `backgroundfetchfail` に設定します。


`options`

*`ExtendableEvent()` で定義されたプロパティに加えて*、下記のプロパティを持つオブジェクト。

`registration`

`BackgroundFetchRegistration` オブジェクト。


### 返値

新しく生成された `BackgroundFetchUpdateUIEvent` オブジェクト。

仕様書
---

| Specification |
| --- |
| Background Fetch # dom-backgroundfetchupdateuievent-backgroundfetchupdateuievent |

ブラウザーの互換性
---------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
MediaList.mediaText
===================

**`mediaText`** は `MediaList` インターフェイスの文字列化プロパティで、この `MediaList` をテキストとして表す文字列を返します。新しい `MediaList` を設定することもできます。

値
-

スタイルシートのメディアクエリーを表す文字列です。それぞれは、 `screen and (min-width: 480px), print` のようにカンマで区切られます。

ドキュメントに新しいメディアクエリーを設定したい場合は、 `screen, print` のように、カンマで区切って文字列を指定する必要があります。 `MediaList` は生きたリストであることに注意してください。 `mediaText` によってリストを更新すると、ドキュメントの動作がすぐに更新されます。

また、 `mediaText` に `null` を設定しようとすると、空文字列として扱われ、その値は `""` に設定されることに注意してください。

例
-

次の例は、現在のドキュメントに適用された最初のスタイルシートの `MediaList` のテキスト表現をコンソールにログ出力するものです。


```css
const stylesheets = document.styleSheets;
let stylesheet = stylesheets[0];
console.log(stylesheet.media.mediaText);
```

仕様書
---

| Specification |
| --- |
| CSS Object Model (CSSOM) # dom-medialist-mediatext |

ブラウザーの互換性
---------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.