recursal/MDN huggingface dataset:
DeviceMotionEvent: rotationRate プロパティ
=====================================

**`DeviceMotionEvent.rotationRate`** は読み取り専用プロパティで、端末がそれぞれの軸を中心に回転している秒あたりの角度を返します。

**メモ:** ハードウェアがこの情報を提供できない場合、このプロパティは `null` を返します。

値
-

`rotationRate` プロパティは読み取り専用のオブジェクトで、端末の各軸に沿った回転速度を記述します。

`alpha`

端末が Z 軸を中心に回転している速度です。つまり、画面に垂直な線を中心に回転している速度です。

`beta`

端末が X 軸、つまり後ろから横に向かう軸を中心に回転している速度です。

`gamma`

端末が Y 軸、つまり横から横へ向かう軸を中心に回転している速度です。

仕様書
---

| Specification |
| --- |
| DeviceOrientation Event Specification # ref-for-dom-devicemotionevent-rotationrate② |

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

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

関連情報
----

* `DeviceMotionEvent`
* `devicemotion` イベント
* `deviceorientation` イベント
* `DeviceOrientationEvent`
* 端末の方向の検出
* 方向および動きとして示されるデータ
EyeDropper: open() メソッド
=======================

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

**`EyeDropper.open()`** メソッドは、スポイトモードを開始し、ユーザーが色を選択してスポイトモードを終了したときに履行されるプロミスを返します。

構文
--


```js
open()
open(options)
```

### 引数

`options` 省略可

`AbortSignal` シグナルを渡す用のオプションオブジェクトです。

`signal`

`AbortSignal` です。`AbortSignal` の `abort()` メソッドを呼ぶと、スポイトモードが終了します。


### 返値

ユーザーが画面から色を選択すると解決する `Promise` です。

この `Promise` は、以下のプロパティを持つオブジェクトで解決します。

`sRGBHex`

選択された色を 16 進 sRGB 形式 (`#aabbcc`) で表す文字列です。

### 例外

例外は投げられるのではなく、`Promise` が拒否されたとき返されます。この `Promise` は以下の 2 通りの場合に拒否されます。

* ユーザーが `Escape` キーを押してスポイトモードをキャンセルしたとき。
* スポイトモードが `open()` の引数として渡した `AbortController` によって終了させられたとき。
仕様書
---

| Specification |
| --- |
| EyeDropper API # dom-eyedropper-open |

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

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

関連情報
----

* 属している `EyeDropper` インターフェイス
EyeDropper: EyeDropper() コンストラクター
=================================

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

**`EyeDropper()`** コンストラクターは、新しい `EyeDropper` オブジェクトを返します。

構文
--


```js
new EyeDropper()
```

### 引数

なし。

仕様書
---

| Specification |
| --- |
| EyeDropper API # eyedropper-interface |

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

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

関連情報
----

* 属している `EyeDropper` インターフェイス
FontFace: style プロパティ
=====================

**`style`** は `FontFace` インターフェイスのプロパティで、フォントのスタイルを取得または設定します。

このプロパティは `font-style` 記述子と等価です。

値
-

スタイルシートの `@font-face` ルールで定義する記述子の入った文字列です。

仕様書
---

| Specification |
| --- |
| CSS Font Loading Module Level 3 # dom-fontface-style |

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

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

**`load()`** は `FontFace` インターフェイスのメソッドで、 `source` が URL で指定されたフォントをリクエストして読み込みます。このメソッドは、現在の `FontFace` オブジェクトで解決される `Promise` を返します。

フォントフェイスの `source` がバイナリーデータを指定されていた場合、またはフォントフェイスのフォント `status` プロパティが `unloaded` 以外であった場合、このメソッドは何も行いません。

構文
--


```js
load()
```

### 引数

なし。

### 返値

`Promise` で、フォントが読み込まれたときは現在の `FontFace` オブジェクトへの参照で解決し、読み込みに失敗したときは `NetworkError` `DOMException` で拒否されます。

### 例外

`NetworkError` `DOMException`

フォントを読み込もうとして失敗したことを示します。

例
-

この単純な例では、フォントを読み込んで、それを使用してキャンバス要素（`js-canvas` の ID を持つ）にテキストを表示します。
```

<canvas id="js-canvas"></canvas>
```



```js
const canvas = document.getElementById("js-canvas");

// Google フォントから "Bitter" フォントを読み込み
const fontFile = new FontFace(
  "FontFamily Style Bitter",
  "url(https://fonts.gstatic.com/s/bitter/v7/HEpP8tJXlWaYHimsnXgfCOvvDin1pK8aKteLpeZ5c0A.woff2)",
);
document.fonts.add(fontFile);

fontFile.load().then(
  () => {
    // フォントを正常に読み込めた
    canvas.width = 650;
    canvas.height = 100;
    const ctx = canvas.getContext("2d");

    ctx.font = '36px "FontFamily Style Bitter"';
    ctx.fillText("Bitter font loaded", 20, 50);
  },
  (err) => {
    console.error(err);
  },
);
```

仕様書
---

| Specification |
| --- |
| CSS Font Loading Module Level 3 # font-face-load |

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

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

**`FontFace.family`** プロパティにより、 `FontFace` オブジェクトのフォントファミリを取得したり設定したりすることができます。

 この値は、 `font-family` プロパティを使用して要素をスタイル設定するときに、特定のフォントフェイスに対して名前を照合するために用いられます。
 任意の名前を使用することができ、これは基盤のフォントデータで指定した名前を上書きします。

このプロパティは `@font-face` の `font-family` 記述子と等価です。

値
-

文字列です。

例
-


```js
let fontFace = new FontFace(
  "Roboto",
  "url(https://fonts.example.com/roboto.woff2)",
);
console.log(fontFace.family); // 'Roboto'

fontFace.family = "newRoboto";
console.log(fontFace.family); // 'newRoboto'
```

仕様書
---

| Specification |
| --- |
| CSS Font Loading Module Level 3 # dom-fontface-family |

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

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

**`status`** は `FontFace` インターフェイスの読み取り専用プロパティで、フォントの状態を示す列挙値 `"unloaded"`、`"loading"`、`"loaded"`、`"error"` のいずれかを返します。

値
-

`"unloaded"`、`"loading"`、`"loaded"`、`"error"` のいずれかです。

仕様書
---

| Specification |
| --- |
| CSS Font Loading Module Level 3 # dom-fontface-status |

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

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

**`unicodeRange`** は `FontFace` インターフェイスのプロパティで、フォントを包含する Unicode コードポイントの範囲を取得または設定します。

このプロパティは `unicode-range` 記述子と等価です。

値
-

スタイルシートの `@font-face` ルールに現れる記述子の入った文字列です。

仕様書
---

| Specification |
| --- |
| CSS Font Loading Module Level 3 # dom-fontface-unicoderange |

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

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

**`weight`** は `FontFace` インターフェイスのプロパティで、フォントの太さを取得または設定します。

このプロパティは `font-weight` 記述子と等価です。

値
-

スタイルシートの `@font-face` ルールで定義するような記述子の入った文字列です。

仕様書
---

| Specification |
| --- |
| CSS Font Loading Module Level 3 # dom-fontface-weight |

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

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

**`featureSettings`** は `FontFace` インターフェイスのプロパティで、フォントのバリアントプロパティでは利用できない、使用する頻度の低いフォント機能を取得または設定します。

このプロパティは `font-feature-settings` 記述子と同等です。

値
-

記述子の入った文字列です。

仕様書
---

| Specification |
| --- |
| CSS Font Loading Module Level 3 # dom-fontface-featuresettings |

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

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

**`variant`** は `FontFace` インターフェイスのプロパティで、プログラムでフォントのバリアント値を取得または設定します。

値
-

スタイルシートの `@font-face` ルールで定義するような記述子の入った文字列です。

仕様書
---

| Specification |
| --- |
| CSS Font Loading Module Level 3 # dom-fontface-variant |

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

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

**`ascentOverride`** は `FontFace` インターフェイスのプロパティで、フォントの ascent メトリック、つまり CSS がインライン整形コンテキストで行ボックスをレイアウトするために使用するベースラインからの高さを返したり設定したりします。

このプロパティは `@font-face` の `@font-face/ascent-override` 記述子と等価です。

値
-

文字列です。使用可能な値は、使用するメトリクスをフォントファイルから取得することを示す `normal` か、パーセント値です。

このプロパティは `@font-face/ascent-override` 記述子と同じ値を受け入れます。

例
-


```js
let fontFace = new FontFace(
  "Roboto",
  "url(https://fonts.example.com/roboto.woff2)",
  { ascentOverride: "90%" },
);
console.log(fontFace.ascentOverride); // 90%
fontFace.ascentOverride = "normal";
console.log(fontFace.ascentOverride); // 'normal'
```

仕様書
---

| Specification |
| --- |
| CSS Font Loading Module Level 3 # dom-fontfacedescriptors-ascentoverride |

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

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

**`loaded`** は `FontFace` インターフェイスの読み取り専用プロパティで、 `Promise` を返します。これはオブジェクトのコンストラクターで指定されたフォントの読み込みが完了した時に、現在の `FontFace` オブジェクトで解決するか、 `SyntaxError` で拒否されます。

値
-

`Promise` で、現在の `FontFace` オブジェクトで解決します。

仕様書
---

| Specification |
| --- |
| CSS Font Loading Module Level 3 # dom-fontface-loaded |

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

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

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

**`variationSettings`** は `FontFace` インターフェイスのプロパティで、低水準の OpenType または TrueType フォントのバリエーションを取得または設定します。

このプロパティは `font-variation-settings` 記述子と等価です。

値
-

記述子の入った文字列です。

仕様書
---

| Specification |
| --- |
| CSS Font Loading Module Level 3 # dom-fontfacedescriptors-variationsettings |

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

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

**`display`** は `FontFace` インターフェイスのプロパティで、フォントフェイスがどのように表示されるかを、それがダウンロードされ使用する準備ができているかどうかに基づいて決定します。
 このプロパティは CSS の `font-display` 記述子に相当します。

 このプロパティが使用されると、フォントの読み込みは 3 つの期間を持つタイムラインを持ちます。
 最初の 2 つの期間の長さは、プロパティの値とユーザーエージェントに依存します。
 （下記参照。）

ブロック期間

ブラウザーは目に見えない形で代替フォントを準備します。この間にフォントフェイスが読み込まれると、それを使用してテキストが表示され、表示が完了します。

スワップ期間

 フォントフェイスがまだ読み込まれていない場合は、代替フォントが表示されます。
 フォントフェイスが読み込まれると、代替フォントがダウンロードしたフォントと入れ替えられます。


失敗期間

フォントフェイスがまだ読み込まれていない場合は、代替フォントが表示され、入れ替えは行われません。

値
-

以下のいずれかの値を持つ文字列です。

`auto`

ユーザーエージェントが指定されたフォント表示方針を使用します。

`block`

 フォントフェイスのブロック期間を短く、スワップ期間を無限にします。
 仕様ではブロック期間は 3 秒を推奨していますが、これはブラウザーによって異なる場合があります。


`fallback`

 フォントフェイスのブロック期間とスワップ期間を短くします。
 仕様では、ブロック期間は 100 ミリ秒以下、スワップ期間は 3 秒以下を推奨していますが、この値はブラウザーによって異なる場合があります。


`optional`

 フォントフェイスのブロック期間を短くし、スワップ期間はなしにします。
 仕様では 100 ミリ秒以下を推奨していますが、これはブラウザーによって異なる場合があります。


`swap`

フォントフェイスのブロック期間を 0 秒に、スワップ期間を無限にします。

仕様書
---

| Specification |
| --- |
| CSS Font Loading Module Level 3 # dom-fontface-display |

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

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

**`FontFace()`** コンストラクターは、新しい `FontFace` オブジェクトを構築します。

構文
--


```js
new FontFace(family, source)
new FontFace(family, source, descriptors)
```

### 引数

`family`

要素をスタイル設定する際に、このフォントフェイスと照合するために使用することができるフォントファミリ名を指定します。

`@font-face` の `font-family` 記述子と同じ型の値を取ります。
 この値は、 `FontFace.family` プロパティを使用して読み込んだり設定したりすることもできます。


`source`

 フォントのソースです。
 以下のいずれかにすることができます。


* フォントフェイスファイルの URL。
* `ArrayBuffer` または `TypedArray` に入ったバイナリーのフォントフェイスデータ。

`descriptors` 省略可

 オブジェクトとして渡すオプションの記述子の集合。
 これは `@font-face` で利用できる任意の記述子を含むことができます。


`ascentOverride`

`@font-face/ascent-override` で許可されでいる値と共に指定します。

`descentOverride`

`@font-face/descent-override` で許可されでいる値と共に指定します。

`display`

`@font-face/font-display` で許可されでいる値と共に指定します。

`featureSettings`

`font-feature-settings` で許可されでいる値と共に指定します。

`lineGapOverride`

`@font-face/line-gap-override` で許可されでいる値と共に指定します。

`stretch`

`@font-face/font-stretch` で許可されでいる値と共に指定します。

`style`

`@font-face/font-style` で許可されでいる値と共に指定します。

`unicodeRange`

`@font-face/unicode-range` で許可されでいる値と共に指定します。

`variationSettings`

`@font-face/font-variation-settings` で許可されでいる値と共に指定します。

`weight`

`@font-face/font-weight` で許可されでいる値と共に指定します。


### 例外

`SyntaxError` `DOMException`

 記述子の文字列が、対応する `@font-face` 記述子の文法に照合しないか、指定するバイナリソースを読み込むことができない場合に発生します。
 このエラーでは `FontFace.status` が `error` に設定されます。


例
-


```js
async function loadFonts() {
  const font = new FontFace("myfont", "url(myfont.woff)", {
    style: "normal",
    weight: "400",
    stretch: "condensed",
  });
  // wait for font to be loaded
  await font.load();
  // add font to document
  document.fonts.add(font);
  // enable font with CSS class
  document.body.classList.add("fonts-loaded");
}
```

仕様書
---

| Specification |
| --- |
| CSS Font Loading Module Level 3 # font-face-constructor |

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

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

関連情報
----

* `@font-face`
FontFace: descentOverride プロパティ
===============================

**`descentOverride`** は `FontFace` インターフェイスのプロパティで、 `@font-face/descent-override` 記述子の値を返したり設定したりします。
 使用できる値は、使用するメトリックをフォントファイルから取得することを示す `normal` か、パーセント値です。

値
-

文字列です。

例
-


```js
let fontFace = new FontFace(
  "Roboto",
  "url(https://fonts.example.com/roboto.woff2)",
  { descentOverride: "90%" },
);
console.log(fontFace.descentOverride); // 90%
fontFace.descentOverride = "normal";
console.log(fontFace.descentOverride); // 'normal'
```

仕様書
---

| Specification |
| --- |
| CSS Font Loading Module Level 3 # dom-fontfacedescriptors-descentoverride |

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

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

**`stretch`** は `FontFace` インターフェイスのプロパティで、フォントの伸縮方法を取得または設定します。

このプロパティは `font-stretch` 記述子と等価です。

値
-

スタイルシートの `@font-face` ルールで定義するような記述子の入った文字列です。

仕様書
---

| Specification |
| --- |
| CSS Font Loading Module Level 3 # dom-fontface-stretch |

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

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

**`lineGapOverride`** は `FontFace` インターフェイスのプロパティで、 `@font-face/line-gap-override` 記述子の値を返したり設定したりします。
 使用可能な値は `normal` で、使用するメトリックをフォントファイルから取得することを示します。

値
-

文字列です。

例
-


```js
let fontFace = new FontFace(
  "Roboto",
  "url(https://fonts.example.com/roboto.woff2)",
  { lineGapOverride: "90%" },
);
console.log(fontFace.lineGapOverride); // 90%
fontFace.lineGapOverride = "normal";
console.log(fontFace.lineGapOverride); // 'normal'
```

仕様書
---

| Specification |
| --- |
| CSS Font Loading Module Level 3 # dom-fontfacedescriptors-linegapoverride |

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

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

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

`PermissionStatus` インターフェイスの **`state`** 読み取り専用プロパティは、要求されたパーミッションの状態を返します。 このプロパティは、`'granted'`（付与）、`'denied'`（拒否）、`'prompt'`（プロンプト）のいずれかを返します。

構文
--
```

var permission = PermissionStatus.state;
```

例
-


```js
navigator.permissions
  .query({ name: "geolocation" })
  .then(function (permissionStatus) {
    console.log(
      "位置情報のパーミッションの状態は " + permissionStatus.state + " です。",
    );
    permissionStatus.onchange = function () {
      console.log(
        "位置情報のパーミッションの状態が " +
          this.state +
          " に変更されました。",
      );
    };
  });
```

仕様
--

| Specification |
| --- |
| Permissions # dom-permissionstatus-state |

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

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

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

`PermissionStatus` インターフェイス の **`onchange`** イベントハンドラは、`PermissionStatus.state` プロパティが変更されるたびに呼び出されます。

構文
--


```js
PermissionStatus.onchange = function() { ... }
PermissionStatus.addEventListener('change', function() { ... })
```

例
-


```js
navigator.permissions
  .query({ name: "geolocation" })
  .then(function (permissionStatus) {
    console.log(
      "位置情報のパーミッションの状態は " + permissionStatus.state + " です。",
    );
    permissionStatus.onchange = function () {
      console.log(
        "位置情報のパーミッションの状態が " +
          this.state +
          " に変更されました。",
      );
    };
  });
```

仕様
--

| Specification |
| --- |
| Permissions # dom-permissionstatus-onchange |

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

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

**`HTMLProgressElement.labels`** は読み取り専用プロパティで、この `<progress>` 要素に関連付けられている `<label>` 要素の `NodeList` を返します。

値
-

この `<progress>` 要素に結びつけられている `<label>` 要素の入った `NodeList` です。

例
-

### HTML


```html
<label id="label1" for="test">Label 1</label>
<progress id="test" value="70" max="100">70%</progress>
<label id="label2" for="test">Label 2</label>
```

### JavaScript


```js
window.addEventListener("DOMContentLoaded", () => {
  const progress = document.getElementById("test");
  for (const label of progress.labels) {
    console.log(label.textContent); // "Label 1" and "Label 2"
  }
});
```

### 結果

仕様書
---

| Specification |
| --- |
| HTML Standard # dom-lfe-labels-dev |

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

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

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

**`code`** は `DOMException` インターフェイスの読み取り専用プロパティで、古いエラーコード定数のいずれか、または一致するものがなければ `0` を返します。

このフィールドは歴史的な理由から使用されています。新しい DOM 例外はこれを使用しなくなっています。この情報は `DOMException.name` 属性に格納するようになりました。

値
-

エラーコード定数のいずれか、または一致するものがなければ `0` を返します。

仕様書
---

| Specification |
| --- |
| Web IDL Standard # dom-domexception-code |

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

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

**`DOMException()`** コンストラクターは、指定されたメッセージと名前を持つ `DOMException` オブジェクトを返します。

構文
--


```js
new DOMException()
new DOMException(message)
new DOMException(message, name)
```

### 引数

`message` 省略可

この例外の説明です。存在しない場合は、空文字列 `''` が使用されます。

`name` 省略可

文字列です。指定された名前が標準エラー名であった場合、その `DOMException` オブジェクトの `code` プロパティは指定された名前に対応するコード番号を返します。

### 返値

新しく作成された `DOMException` オブジェクトです。

例
-

この例では、ボタンを押すと独自の `DOMException` が発生し、それがキャッチされ、独自のエラーメッセージがアラートに表示されます。

### HTML


```html
<button>Trigger DOM Exception</button>

<p id="output"></p>
```

### JavaScript


```js
const button = document.querySelector("button");

button.onclick = () => {
  try {
    throw new DOMException("Custom DOM Exception Triggered.");
  } catch (error) {
    document.querySelector("#output").textContent = `Error: ${error.message}`;
  }
};
```

### 例

仕様書
---

| Specification |
| --- |
| Web IDL Standard # dom-domexception-domexception |

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

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

関連情報
----

* `DOMException` コンストラクターのポリフィルが `core-js` で利用できます
DOMException: name プロパティ
========================

**`name`** は `DOMException` インターフェイスの読み取り専用プロパティで、エラー名に結びつけられた文字列のうちの 1 つを含む文字列を返します。

値
-

文字列です。

仕様書
---

| Specification |
| --- |
| Web IDL Standard # dom-domexception-name |

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

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

**`message`** は `DOMException` インターフェイスの読み取り専用プロパティで、指定されたエラー名に結びつけられたメッセージまたは説明文を表す文字列を返します。

値
-

文字列です。

仕様書
---

| Specification |
| --- |
| Web IDL Standard # dom-domexception-message |

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

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

**`HTMLAreaElement.host`** プロパティは、ホストを含む文字列です。すなわち、*ホスト名*の後に、 URL の*ポート*が空でない場合は、`':'`、および URL の*ポート*が続きます。

値
-

文字列です。

例
-


```js
const area = document.createElement("area");

area.href = "https://developer.mozilla.org/en-US/HTMLAreaElement";
area.host === "developer.mozilla.org";

area.href = "https://developer.mozilla.org:443/en-US/HTMLAreaElement";
area.host === "developer.mozilla.org";
// ポート番号は、 443 がスキームの既定のポートであるため含まれない

area.href = "https://developer.mozilla.org:4097/en-US/HTMLAreaElement";
area.host === "developer.mozilla.org:4097";
```

仕様書
---

| Specification |
| --- |
| HTML Standard # dom-hyperlink-host-dev |

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

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

関連情報
----

* 所属先の `HTMLAreaElement` インターフェイス
HTMLAreaElement: protocol プロパティ
===============================

**`HTMLAreaElement.protocol`** プロパティは、 URL のプロトコルスキームを表す文字列で、最後の `':'` を含みます。

値
-

文字列です。

例
-

### エリアのリンクのプロトコルを取得


```js
// <area id="myArea" href="https://developer.mozilla.org/en-US/HTMLAreaElement"> 要素が文書にあったとします。
const area = document.getElementById("myArea");
area.protocol; // 'https:' を返す
```

仕様書
---

| Specification |
| --- |
| HTML Standard # dom-hyperlink-protocol-dev |

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

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

関連情報
----

* 所属先の `HTMLAreaElement` インターフェイス
HTMLAreaElement: username プロパティ
===============================

**`HTMLAreaElement.username`** プロパティは、ドメイン名の前で指定されたユーザー名の入った文字列です。

値
-

文字列です。

例
-

### エリアのリンクからユーザー名を取得


```js
// <area id="myArea" href="https://anonymous:flabada@developer.mozilla.org/ja/docs/HTMLAreaElement"> 要素が文書にあったとします
const area = document.getElementByID("myArea");
area.username; // 'anonymous' を返す
```

仕様書
---

| Specification |
| --- |
| HTML Standard # dom-hyperlink-username-dev |

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

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

関連情報
----

* 所属先の `HTMLAreaElement` インターフェイス
HTMLAreaElement: search プロパティ
=============================

**`HTMLAreaElement.search`** プロパティは、*クエリー文字列*とも呼ばれる検索文字列、つまり `'?'` とその後に続く URL の引数の入った文字列です。

最新のブラウザーでは、`URLSearchParams` と `URL.searchParams` を提供して、クエリー文字列から引数を簡単に解析できるようにしています。

値
-

文字列です。

例
-

### エリアのリンクから検索文字列を取得


```js
// <area id="myArea" href="/ja/docs/HTMLAreaElement?q=123"> 要素が文書内にあったとします
const area = document.getElementById("myArea");
area.search; // '?q=123' を返す
```

### URLSearchParams を使用した高度な解釈

他にも、 `URLSearchParams` が使われる場面があります。


```js
let params = new URLSearchParams(queryString);
let q = parseInt(params.get("q")); // 数値 123 を返す
```

仕様書
---

| Specification |
| --- |
| HTML Standard # dom-hyperlink-search-dev |

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

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

関連情報
----

* 所属先の `HTMLAreaElement` インターフェイス
HTMLAreaElement: port プロパティ
===========================

**`HTMLAreaElement.port`** プロパティは、URL のポート番号が入った文字列です。 URL に明示的にポート番号が含まれていない場合は、`''` に設定されます。

値
-

文字列です。

例
-

### エリアのリンクからポート番号を取得


```js
// <area id="myArea" href="https://developer.mozilla.org:443/ja/docs/HTMLAreaElement"> 要素が文書にあったとします。
const area = document.getElementByID("myArea");
area.port; // '443' を返す
```

仕様書
---

| Specification |
| --- |
| HTML Standard # dom-hyperlink-port-dev |

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

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

関連情報
----

* 所属先の `HTMLAreaElement` インターフェイス
HTMLAreaElement: toString() メソッド
================================

**`HTMLAreaElement.toString()`** は文字列化メソッドで、 URL 全体の入った文字列を返します。 これは、 `HTMLAreaElement.href` の読み取り専用バージョンです。

構文
--


```js
toString()
```

### 引数

なし。

### 返値

この要素の完全な URL の入った文字列です。

例
-

### エリア要素で toString を呼び出す


```js
// <area id="myArea" href="/ja/docs/HTMLAreaElement"> 要素が文書にあったとします
const area = document.getElementById("myArea");
area.toString(); // 'https://developer.mozilla.org/ja/docs/HTMLAreaElement' を返す
```

仕様書
---

| Specification |
| --- |
| HTML Standard # dom-hyperlink-href-dev |

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

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

関連情報
----

* 所属先の `HTMLAreaElement` インターフェイス
HTMLAreaElement: href プロパティ
===========================

**`HTMLAreaElement.href`** は文字列化プロパティで、URL 全体を含む文字列を返し、href を更新することができます。

値
-

文字列です。

例
-


```js
// <area id="myArea" href="https://developer.mozilla.org/en-US/HTMLAreaElement"> 要素が文書にあったとします
const area = document.getElementById("myArea");
area.href; // 'https://developer.mozilla.org/en-US/HTMLAreaElement' を返す
```

仕様書
---

| Specification |
| --- |
| HTML Standard # dom-hyperlink-href-dev |

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

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

関連情報
----

* 所属先の `HTMLAreaElement` インターフェイス