diff options
Diffstat (limited to 'files/ja/web/api/url')
-rw-r--r-- | files/ja/web/api/url/createobjecturl/index.html | 104 | ||||
-rw-r--r-- | files/ja/web/api/url/hash/index.html | 62 | ||||
-rw-r--r-- | files/ja/web/api/url/host/index.html | 68 | ||||
-rw-r--r-- | files/ja/web/api/url/hostname/index.html | 60 | ||||
-rw-r--r-- | files/ja/web/api/url/href/index.html | 61 | ||||
-rw-r--r-- | files/ja/web/api/url/index.html | 153 | ||||
-rw-r--r-- | files/ja/web/api/url/origin/index.html | 68 | ||||
-rw-r--r-- | files/ja/web/api/url/password/index.html | 63 | ||||
-rw-r--r-- | files/ja/web/api/url/pathname/index.html | 61 | ||||
-rw-r--r-- | files/ja/web/api/url/port/index.html | 61 | ||||
-rw-r--r-- | files/ja/web/api/url/protocol/index.html | 61 | ||||
-rw-r--r-- | files/ja/web/api/url/revokeobjecturl/index.html | 75 | ||||
-rw-r--r-- | files/ja/web/api/url/search/index.html | 62 | ||||
-rw-r--r-- | files/ja/web/api/url/searchparams/index.html | 58 | ||||
-rw-r--r-- | files/ja/web/api/url/tojson/index.html | 60 | ||||
-rw-r--r-- | files/ja/web/api/url/tostring/index.html | 64 | ||||
-rw-r--r-- | files/ja/web/api/url/url/index.html | 105 | ||||
-rw-r--r-- | files/ja/web/api/url/username/index.html | 61 |
18 files changed, 1307 insertions, 0 deletions
diff --git a/files/ja/web/api/url/createobjecturl/index.html b/files/ja/web/api/url/createobjecturl/index.html new file mode 100644 index 0000000000..bd05df9f05 --- /dev/null +++ b/files/ja/web/api/url/createobjecturl/index.html @@ -0,0 +1,104 @@ +--- +title: URL.createObjectURL() +slug: Web/API/URL/createObjectURL +tags: + - API + - Blob + - DOM + - Reference + - URL + - URL API + - createObjectURL +translation_of: Web/API/URL/createObjectURL +--- +<p><strong><code>URL.createObjectURL()</code></strong> 静的メソッドは、引数で指定されたオブジェクトを表す URL を含む {{domxref("DOMString")}} を生成します。 URL の寿命は、それを作成したウィンドウ内の {{domxref("document")}} と結び付けられています。 新しいオブジェクト URL は、指定された {{domxref("File")}} オブジェクトか {{domxref("Blob")}} オブジェクトを表します。</p> + +<p>オブジェクト URL を解放するには、 {{domxref("URL.revokeObjectURL", "revokeObjectURL()")}} を呼び出してください。</p> + +<p>{{AvailableInWorkers}}</p> + +<div class="note"> +<p><strong>メモ:</strong> この機能はメモリリークを生み出す可能性があるため、<a href="/ja/docs/Web/API/Service_Worker_API">サービスワーカー</a>内で利用することは<em>できません</em>。</p> +</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox"><em>objectURL</em> = URL.createObjectURL(<em>object</em>); +</pre> + +<h3 id="Parameters" name="Parameters">引数</h3> + +<dl> + <dt><code>object</code></dt> + <dd>オブジェクト URL を生成するための {{domxref("File")}}, {{domxref("Blob")}}, {{domxref("MediaSource")}} の何れかのオブジェクトです。</dd> +</dl> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p><code>object</code> で指定された内容を参照するために使用されるオブジェクト URL を含んだ {{domxref("DOMString")}} です。</p> + +<h2 id="Example" name="Example">例</h2> + +<p><a href="/ja/docs/Web/API/File/Using_files_from_web_applications#Example:_Using_object_URLs_to_display_images +">オブジェクト URL で画像を表示</a>を参照してください。</p> + +<h2 id="Usage_notes" name="Usage_notes">使用上のメモ</h2> + +<h3 id="Memory_management" name="Memory_management">メモリ管理</h3> + +<p>すでにオブジェクト URL が生成されている場合でも、 <code>createObjectURL()</code> を呼び出す度に、新しいオブジェクト URL が生成されます。 必要がなくなったら {{domxref("URL.revokeObjectURL()")}} を呼び出して、それぞれを解放してください。</p> + +<p>ブラウザーは、文書がアンロードされた際にこれらのオブジェクト URL をメモリから解放します。 しかし、性能とメモリ使用を考慮すると、明示的にアンロードできる安全な機会があるならば、そうするべきです。</p> + +<h3 id="Using_object_URLs_for_media_streams" name="Using_object_URLs_for_media_streams">メディアストリームのオブジェクト URL の使用</h3> + +<p>古いバージョンの Media Source 仕様書では、 {{HTMLElement("video")}} 要素にストリームを添付するには {{domxref("MediaStream")}} にオブジェクト URL を生成する必要があるとしてます。 これはもう必要なく、ブラウザーはこのようにする対応を削除してきています。</p> + +<div class="warning"> +<p><strong>重要:</strong> もし {{domxref("URL.createObjectURL", "createObjectURL()")}} でメディア要素にストリームを割り当てるコードが残っているのであれば、単純に {{domxref("HTMLMediaElement.srcObject", "srcObject")}} を直接 <code>MediaStream</code> に設定するよう更新する必要があります。</p> +</div> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">仕様書</th> + <th scope="col">状態</th> + <th scope="col">備考</th> + </tr> + <tr> + <td>{{SpecName('File API', '#dfn-createObjectURL', 'createObjectURL()')}}</td> + <td>{{Spec2('File API')}}</td> + <td>初回定義</td> + </tr> + <tr> + <td>{{SpecName('Media Source Extensions', '#dom-url-createobjecturl', 'URL')}}</td> + <td>{{Spec2('Media Source Extensions')}}</td> + <td> + <p>MediaSource 拡張</p> + + <p>Older versions of this specification used <code>createObjectURL()</code> for {{domxref("MediaStream")}} objects; this is no longer supported.</p> + </td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの対応</h2> + +<p class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力したいのであれば、 <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</p> + +<p>{{Compat("api.URL.createObjectURL")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li><a href="/ja/docs/Web/API/File/Using_files_from_web_applications">Web アプリケーションからファイルを扱う</a></li> + <li><a href="/ja/docs/Web/API/File/Using_files_from_web_applications#Example:_Using_object_URLs_to_display_images +">オブジェクト URL で画像を表示</a></li> + <li>{{domxref("URL.revokeObjectURL()")}}</li> + <li>{{domxref("HTMLMediaElement.srcObject")}}</li> + <li>{{domxref("FileReader.readAsDataURL()")}}</li> +</ul> + +<div>{{APIRef("URL")}}</div> diff --git a/files/ja/web/api/url/hash/index.html b/files/ja/web/api/url/hash/index.html new file mode 100644 index 0000000000..40b4505b6c --- /dev/null +++ b/files/ja/web/api/url/hash/index.html @@ -0,0 +1,62 @@ +--- +title: URL.hash +slug: Web/API/URL/hash +tags: + - API + - Hash + - Property + - Reference + - URL +translation_of: Web/API/URL/hash +--- +<div>{{ APIRef("URL API") }}</div> + +<p>{{domxref("URL")}} インターフェイスの <strong><code>hash</code></strong> プロパティは、<code>'#'</code> の後に URL のフラグメント識別子が続く {{domxref("USVString")}} を返します。</p> + +<p>フラグメントは<a href="/ja/docs/Glossary/percent-encoding">パーセントデコード</a>されていません。 URL にフラグメント識別子がない場合、このプロパティには空の文字列 <code>""</code> が含まれます。</p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox"><em>string</em> = <em>object</em>.hash; +<em>object</em>.hash = <em>string</em>; +</pre> + +<h3 id="Value" name="Value">値</h3> + +<p>{{domxref("USVString")}}。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<pre class="brush: html">var url = new URL('https://developer.mozilla.org/en-US/docs/Web/API/URL/href#Examples'); +url.hash // '#Examples' を返します</pre> + +<h2 id="Specifications" name="Specifications">仕様</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">仕様</th> + <th scope="col">状態</th> + <th scope="col">コメント</th> + </tr> + <tr> + <td>{{SpecName('URL', '#dom-url-hash', 'URL.hash')}}</td> + <td>{{Spec2('URL')}}</td> + <td>初期定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + + + +<p>{{Compat("api.URL.hash")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{domxref("URL")}} インターフェイスに属します。</li> +</ul> diff --git a/files/ja/web/api/url/host/index.html b/files/ja/web/api/url/host/index.html new file mode 100644 index 0000000000..1c8a57f786 --- /dev/null +++ b/files/ja/web/api/url/host/index.html @@ -0,0 +1,68 @@ +--- +title: URL.host +slug: Web/API/URL/host +tags: + - API + - Host + - Property + - Reference + - URL +translation_of: Web/API/URL/host +--- +<div>{{ApiRef("URL API")}}</div> + +<p>{{domxref("URL")}} インターフェイスの <strong><code>host</code></strong> プロパティは、ホストを含む {{domxref("USVString")}} です。 ホストは、<em>ホスト名</em>の後に、URL の<em>ポート</em>が空でない場合、<code>':'</code>、および URL の<em>ポート</em>が続きます。</p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox"><em>string</em> = <em>object</em>.host; +<em>object.<code>host</code></em> = <em>string</em>; +</pre> + +<h3 id="Value" name="Value">値</h3> + +<p>{{domxref("USVString")}}。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<pre class="brush: js">var url = new URL('https://developer.mozilla.org/en-US/docs/Web/API/URL/host'); +var result = url.host // "developer.mozilla.org" + +var url = new URL('https://developer.mozilla.org:443/en-US/docs/Web/API/URL/host'); +var result = url.host // "developer.mozilla.org" +// 443 がスキームのデフォルトポートであるため、ポート番号は含まれません + +var url = new URL('https://developer.mozilla.org:4097/en-US/docs/Web/API/URL/host'); +var result = url.host // "developer.mozilla.org:4097" +</pre> + +<h2 id="Specifications" name="Specifications">仕様</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">仕様</th> + <th scope="col">状態</th> + <th scope="col">コメント</th> + </tr> + <tr> + <td>{{SpecName('URL', '#dom-url-host', 'URL.host')}}</td> + <td>{{Spec2('URL')}}</td> + <td>初期定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + + + +<p>{{Compat("api.URL.host")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{domxref("URL")}} インターフェイスに属します。</li> +</ul> diff --git a/files/ja/web/api/url/hostname/index.html b/files/ja/web/api/url/hostname/index.html new file mode 100644 index 0000000000..77f19bbe91 --- /dev/null +++ b/files/ja/web/api/url/hostname/index.html @@ -0,0 +1,60 @@ +--- +title: URL.hostname +slug: Web/API/URL/hostname +tags: + - API + - Property + - Reference + - URL + - hostname +translation_of: Web/API/URL/hostname +--- +<div>{{ApiRef("URL API")}}</div> + +<p><span class="seoSummary">{{domxref("URL")}} インターフェイスの <strong><code>hostname</code></strong> プロパティは、URL のドメインを含む {{domxref("USVString")}} です。</span></p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox"><em>string</em> = <em>object</em>.hostname; +<em>object.</em>hostname = <em>string</em>; +</pre> + +<h3 id="Value" name="Value">値</h3> + +<p>{{domxref("USVString")}}。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<pre class="brush: js">var url = new URL('https://developer.mozilla.org/en-US/docs/Web/API/URL/hostname'); +var result = url.hostname; // 戻り値: 'developer.mozilla.org'</pre> + +<h2 id="Specifications" name="Specifications">仕様</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">仕様</th> + <th scope="col">状態</th> + <th scope="col">コメント</th> + </tr> + <tr> + <td>{{SpecName('URL', '#dom-url-hostname', 'URL.hostname')}}</td> + <td>{{Spec2('URL')}}</td> + <td>初期定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + + + +<p>{{Compat("api.URL.hostname")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{domxref("URL")}} インターフェイスに属します。</li> +</ul> diff --git a/files/ja/web/api/url/href/index.html b/files/ja/web/api/url/href/index.html new file mode 100644 index 0000000000..5bd02f0e51 --- /dev/null +++ b/files/ja/web/api/url/href/index.html @@ -0,0 +1,61 @@ +--- +title: URL.href +slug: Web/API/URL/href +tags: + - API + - Property + - Reference + - URL + - href +translation_of: Web/API/URL/href +--- +<div>{{ApiRef("URL API")}}</div> + +<p><span class="seoSummary">{{domxref("URL")}} インターフェイスの <strong><code>href</code></strong> プロパティは、URL 全体を含む {{domxref("USVString")}} です。</span></p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox"><em>string</em> = <em>object</em>.href; +<em>object<code>.href = </code></em><code><em>string</em>;</code> +</pre> + +<h3 id="Value" name="Value">値</h3> + +<p>{{domxref("USVString")}}。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<pre class="brush: js">var url = new URL('https://developer.mozilla.org/en-US/docs/Web/API/URL/href'); +var result = url.href; // 戻り値: 'https://developer.mozilla.org/en-US/docs/Web/API/URL/href' +</pre> + +<h2 id="Specifications" name="Specifications">仕様</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">仕様</th> + <th scope="col">状態</th> + <th scope="col">コメント</th> + </tr> + <tr> + <td>{{SpecName('URL', '#dom-url-href', 'URL.href')}}</td> + <td>{{Spec2('URL')}}</td> + <td>初期定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + + + +<p>{{Compat("api.URL.href")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{domxref("URL")}} インターフェイスに属します。</li> +</ul> diff --git a/files/ja/web/api/url/index.html b/files/ja/web/api/url/index.html new file mode 100644 index 0000000000..891a0726b6 --- /dev/null +++ b/files/ja/web/api/url/index.html @@ -0,0 +1,153 @@ +--- +title: URL +slug: Web/API/URL +tags: + - API + - Address + - Domain + - Interface + - Location + - Networking + - Reference + - URI + - URL API + - Web + - hostname + - href + - origin +translation_of: Web/API/URL +--- +<p>{{APIRef("URL API")}}</p> + +<p><span class="seoSummary"><strong><code>URL</code></strong> インターフェイスは、{{glossary("URL", "URL")}} の解析、構築、正規化、およびエンコードに使用します。 URL のコンポーネントを簡単に読み取って変更できるプロパティを提供することで機能します。</span> 通常、新しい <code>URL</code> オブジェクトを作成するにはコンストラクターを呼び出すときに URL を文字列として指定するか、相対 URL とベース URL を指定します。その後、解析された URL のコンポーネントを簡単に読み取ったり、URL を変更したりすることができます。</p> + +<p>ブラウザーがまだ {{domxref("URL.URL", "URL()")}} コンストラクターをサポートしていない場合は、{{domxref("Window")}} インターフェイスの {{domxref("Window.URL")}} プロパティを使用して <code>URL</code> オブジェクトにアクセスできます。 対象とするブラウザーのいずれかに、この接頭辞を付ける必要があるかどうかを確認してください。</p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="Constructor" name="Constructor">コンストラクター</h2> + +<dl> + <dt>{{domxref("URL.URL", "new URL()")}}</dt> + <dd>絶対 URL 文字列、または相対 URL 文字列とベース URL 文字列を使用して指定された URL を参照する <code>URL</code> オブジェクトを作成して返します。</dd> +</dl> + +<h2 id="Properties" name="Properties">プロパティ</h2> + +<dl> + <dt>{{domxref("URL.hash", "hash")}}</dt> + <dd><code>'#'</code> に続いて URL のフラグメント識別子を含む {{domxref("USVString")}}。</dd> + <dt>{{domxref("URL.host", "host")}}</dt> + <dd>ドメイン(<em>ホスト名</em>)に続いて(ポートが指定されている場合)、<code>':'</code> と URL の<em>ポート</em>を含む {{domxref("USVString")}}。</dd> + <dt>{{domxref("URL.hostname", "hostname")}}</dt> + <dd>URL のドメインを含む {{domxref("USVString")}}。</dd> + <dt>{{domxref("URL.href", "href")}}</dt> + <dd>URL 全体を含む {{domxref("USVString")}} を返す文字列化関数です。</dd> + <dt>{{domxref("URL.origin", "origin")}} {{readonlyInline}}</dt> + <dd>URL のオリジン、つまりそのスキーム、ドメイン、およびポートを含む {{domxref("USVString")}} を返します。</dd> + <dt>{{domxref("URL.password", "password")}}</dt> + <dd>ドメイン名の前に指定されたパスワードを含む {{domxref("USVString")}}。</dd> + <dt>{{domxref("URL.pathname", "pathname")}}</dt> + <dd>最初の <code>'/'</code> に続いて URL のパスを含む {{domxref("USVString")}}。</dd> + <dt>{{domxref("URL.port", "port")}}</dt> + <dd>URL のポート番号を含む {{domxref("USVString")}}。</dd> + <dt>{{domxref("URL.protocol", "protocol")}}</dt> + <dd>最後の <code>':'</code> までを含めた URL のプロトコルスキームを含む {{domxref("USVString")}}。</dd> + <dt>{{domxref("URL.search", "search")}}</dt> + <dd>URL 引数文字列を示す {{domxref("USVString")}}。 引数が指定されている場合、この文字列には先頭の <code>?</code> 文字で始まるすべての引数が含まれます。</dd> + <dt>{{domxref("URL.searchParams", "searchParams")}} {{readonlyInline}}</dt> + <dd><code>search</code> で見つかった個々のクエリー引数にアクセスするために使用できる {{domxref("URLSearchParams")}} オブジェクト。</dd> + <dt>{{domxref("URL.username","username")}}</dt> + <dd>ドメイン名の前に指定されたユーザー名を含む {{domxref("USVString")}}。</dd> +</dl> + +<h2 id="Methods" name="Methods">メソッド</h2> + +<dl> + <dt>{{domxref("URL.toString", "toString()")}}</dt> + <dd>URL 全体を含む {{domxref("USVString")}} を返します。 {{domxref("URL.href")}} と同義ですが、値の変更に使用することはできません。</dd> + <dt>{{domxref("URL.toJSON", "toJSON()")}}</dt> + <dd>URL 全体を含む {{domxref("USVString")}} を返します。 <code>href</code> プロパティと同じ文字列を返します。</dd> +</dl> + +<h2 id="Static_methods" name="Static_methods">静的メソッド</h2> + +<dl> + <dt>{{domxref("URL.createObjectURL", "createObjectURL()")}}</dt> + <dd>一意の blob URL を含む {{domxref("DOMString")}} を返します。 これは、スキームとして <code>blob:</code> を含む URL で、その後にブラウザー内のオブジェクトを一意に識別する不透明な文字列が続きます。</dd> + <dt>{{domxref("URL.revokeObjectURL", "revokeObjectURL()")}}</dt> + <dd>{{domxref("URL.createObjectURL()")}} を使用して以前に生成したオブジェクト URL を取り消します。</dd> +</dl> + +<h2 id="Usage_notes" name="Usage_notes">使用上の注意</h2> + +<p>コンストラクターは、<code>url</code> 引数と、<code>url</code> 引数が相対 URL の場合にベースとして使用するオプションの <code>base</code> 引数を受け取ります。</p> + +<pre class="brush: js notranslate">const url = new URL('../cats', 'http://www.example.com/dogs'); +console.log(url.hostname); // "www.example.com" +console.log(url.pathname); // "/cats" +</pre> + +<p>URL を構築するために URL のプロパティを設定できます。</p> + +<pre class="brush: js notranslate">url.hash = 'tabby'; +console.log(url.href); // "http://www.example.com/cats#tabby" +</pre> + +<p>URL は、{{RFC(3986)}} にあるルールに従ってエンコードされます。 例えば、次のとおりです。</p> + +<pre class="brush: js notranslate">url.pathname = 'démonstration.html'; +console.log(url.href); // "http://www.example.com/d%C3%A9monstration.html" +</pre> + +<p>URL のクエリー文字列を構築および操作するために、{{domxref("URLSearchParams")}} インターフェイスを使用できます。</p> + +<p>現在のウィンドウの URL から検索引数を取得するには、次のようにします。</p> + +<pre class="brush: js notranslate">// https://some.site/?id=123 +const parsedUrl = new URL(window.location.href); +console.log(parsedUrl.searchParams.get("id")); // "123" +</pre> + +<p>URL の <code>toString()</code> メソッドは <code>href</code> プロパティの値を返すだけなので、コンストラクターを使用して URL を直接に正規化およびエンコードできます。</p> + +<pre class="brush: js notranslate">const response = await fetch(new URL('http://www.example.com/démonstration.html'));</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + <th scope="col">状態</th> + <th scope="col">備考</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('File API', '#creating-revoking', 'URL')}}</td> + <td>{{Spec2('File API')}}</td> + <td>静的メソッドの <code>URL.createObjectURL()</code> と <code>URL.revokeObjectURL()</code> の追加。</td> + </tr> + <tr> + <td>{{SpecName('URL', '#api', 'API')}}</td> + <td>{{Spec2('URL')}}</td> + <td>初回定義 (<code>URLUtils</code> を実装)。</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("api.URL")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li><a href="/ja/docs/Web/API/URL_API">URL API</a></li> + <li><a href="/ja/docs/Learn/Common_questions/What_is_a_URL">URL とは何か</a></li> + <li><code>URL</code> オブジェクトを取得するプロパティ: {{domxref("Window.URL")}}</li> + <li>{{domxref("URLSearchParams")}}</li> +</ul> diff --git a/files/ja/web/api/url/origin/index.html b/files/ja/web/api/url/origin/index.html new file mode 100644 index 0000000000..275a99f1ab --- /dev/null +++ b/files/ja/web/api/url/origin/index.html @@ -0,0 +1,68 @@ +--- +title: URL.origin +slug: Web/API/URL/origin +tags: + - API + - Property + - Read-only + - Reference + - URL + - URL API + - origin +translation_of: Web/API/URL/origin +--- +<div>{{APIRef("URL API")}}</div> + +<p><span class="seoSummary">{{domxref("URL")}} インターフェイスの <strong><code>origin</code></strong> 読み取り専用プロパティは、表現された URL のオリジンの Unicode シリアル化を含む {{domxref("USVString")}} を返します。</span> 正確な構造は、次のように URL のタイプによって異なります。</p> + +<ul> + <li><code>http</code> または <code>https</code> の URL の場合、スキームの後に <code>'://'</code>、ドメイン、<code>':'</code>、ポートが順に続きます。 (ポート部分は、明示的に指定されていて、それがデフォルトポートでない場合に存在します。 それぞれのデフォルトポートは、<code>80</code> と <code>443</code> です。)</li> + <li><code>file:</code> URL の場合、値はブラウザーに依存します。</li> + <li><code>blob:</code> URL の場合、<code>blob:</code> に続く URL のオリジンが使用されます。 例えば、<code>"blob:https://mozilla.org"</code> は <code>"https://mozilla.org"</code> として返されます。</li> +</ul> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox"><em>string</em> = <em>URLObject</em>.origin; +</pre> + +<h3 id="Value" name="Value">値</h3> + +<p>{{domxref("USVString")}}。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<pre class="brush: js">var url = new URL("blob:https://mozilla.org:443/") +url.origin; // 'https://mozilla.org' を返します +</pre> + +<h2 id="Specifications" name="Specifications">仕様</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">仕様</th> + <th scope="col">状態</th> + <th scope="col">コメント</th> + </tr> + <tr> + <td>{{SpecName('URL', '#dom-url-origin', 'URL.origin')}}</td> + <td>{{Spec2('URL')}}</td> + <td>初期定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + + + +<p>{{Compat("api.URL.origin")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{domxref("URL")}} インターフェイスに属します。</li> +</ul> diff --git a/files/ja/web/api/url/password/index.html b/files/ja/web/api/url/password/index.html new file mode 100644 index 0000000000..b34ee0980b --- /dev/null +++ b/files/ja/web/api/url/password/index.html @@ -0,0 +1,63 @@ +--- +title: URL.password +slug: Web/API/URL/password +tags: + - API + - Property + - Reference + - URL + - password +translation_of: Web/API/URL/password +--- +<div>{{ApiRef("URL API")}}</div> + +<p><span class="seoSummary">{{domxref("URL")}} インターフェイスの <strong><code>password</code></strong> プロパティは、ドメイン名の前に指定されたパスワードを含む {{domxref("USVString")}} です。</span></p> + +<p>最初に <code><a href="/ja/docs/Web/API/URL/username">username</a></code> プロパティを設定せずに設定しようとすると、静かに失敗します。</p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox"><em>string</em> = <em>object</em>.password; +<em>object</em>.password = <em>string</em>; +</pre> + +<h3 id="Value" name="Value">値</h3> + +<p>{{domxref("USVString")}}。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<pre class="brush: js">var url = new URL('https://anonymous:flabada@developer.mozilla.org/en-US/docs/Web/API/URL/password'); +var result = url.password; // 戻り値: "flabada" +</pre> + +<h2 id="Specifications" name="Specifications">仕様</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">仕様</th> + <th scope="col">状態</th> + <th scope="col">コメント</th> + </tr> + <tr> + <td>{{SpecName('URL', '#dom-url-password', 'URL.password')}}</td> + <td>{{Spec2('URL')}}</td> + <td>初期定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + + + +<p>{{Compat("api.URL.password")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{domxref("URL")}} インターフェイスに属します。</li> +</ul> diff --git a/files/ja/web/api/url/pathname/index.html b/files/ja/web/api/url/pathname/index.html new file mode 100644 index 0000000000..9b7b596c8c --- /dev/null +++ b/files/ja/web/api/url/pathname/index.html @@ -0,0 +1,61 @@ +--- +title: URL.pathname +slug: Web/API/URL/pathname +tags: + - API + - Property + - Reference + - URL + - pathname +translation_of: Web/API/URL/pathname +--- +<div>{{ApiRef("URL API")}}</div> + +<p><span class="seoSummary">{{domxref("URL")}} インターフェイスの <strong><code>pathname</code></strong> プロパティは、最初の <code>'/'</code> とその後に続く URL のパス(またはパスがない場合は空の文字列)を含む {{domxref("USVString")}} です。</span></p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox"><em>string</em> = <em>object</em>.pathname; +<em>object</em>.pathname = <em>string</em>; +</pre> + +<h3 id="Value" name="Value">値</h3> + +<p>{{domxref("USVString")}}。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<pre class="brush: js">var url = new URL('https://developer.mozilla.org/en-US/docs/Web/API/URL/pathname'); +var result = url.pathname; // 戻り値: "/en-US/docs/Web/API/URL/pathname" +</pre> + +<h2 id="Specifications" name="Specifications">仕様</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">仕様</th> + <th scope="col">状態</th> + <th scope="col">コメント</th> + </tr> + <tr> + <td>{{SpecName('URL', '#dom-url-pathname', 'URL.pathname')}}</td> + <td>{{Spec2('URL')}}</td> + <td>初期定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + + + +<p>{{Compat("api.URL.pathname")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{domxref("URL")}} インターフェイスに属します。</li> +</ul> diff --git a/files/ja/web/api/url/port/index.html b/files/ja/web/api/url/port/index.html new file mode 100644 index 0000000000..470cea03af --- /dev/null +++ b/files/ja/web/api/url/port/index.html @@ -0,0 +1,61 @@ +--- +title: URL.port +slug: Web/API/URL/port +tags: + - API + - Property + - Reference + - URL + - port +translation_of: Web/API/URL/port +--- +<div>{{ApiRef("URL API")}}</div> + +<p><span class="seoSummary">{{domxref("URL")}} インターフェイスの <strong><code>port</code></strong> プロパティは、URL のポート番号を含む {{domxref("USVString")}} です。 URL に明示的なポート番号が含まれていない場合は、<code>''</code> に設定されます。</span></p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox"><em>string</em> = <em>object</em>.port; +<em>object</em>.port = <em>string</em>; +</pre> + +<h3 id="Value" name="Value">値</h3> + +<p>{{domxref("USVString")}}。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<pre class="brush: js">var url = new URL('<span class="message-body-wrapper"><span class="message-flex-body"><span class="devtools-monospace message-body"><span class="cm-string">https://mydomain.com:80/svn/Repos/</span></span></span></span>'); +var result = url.port; // 戻り値: '80' +</pre> + +<h2 id="Specifications" name="Specifications">仕様</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">仕様</th> + <th scope="col">状態</th> + <th scope="col">コメント</th> + </tr> + <tr> + <td>{{SpecName('URL', '#dom-url-port', 'URL.port')}}</td> + <td>{{Spec2('URL')}}</td> + <td>初期定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + + + +<p>{{Compat("api.URL.port")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{domxref("URL")}} インターフェイスに属します。</li> +</ul> diff --git a/files/ja/web/api/url/protocol/index.html b/files/ja/web/api/url/protocol/index.html new file mode 100644 index 0000000000..38383f3e13 --- /dev/null +++ b/files/ja/web/api/url/protocol/index.html @@ -0,0 +1,61 @@ +--- +title: URL.protocol +slug: Web/API/URL/protocol +tags: + - API + - Property + - Protocol + - Reference + - URL +translation_of: Web/API/URL/protocol +--- +<div>{{ApiRef("URL API")}}</div> + +<p><span class="seoSummary">{{domxref("URL")}} インターフェイスの <strong><code>protocol</code></strong> プロパティは、最後の <code>':'</code> を含む URL のプロトコルスキームを表す {{domxref("USVString")}} です。</span></p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox"><em>string</em> = <em>object</em>.protocol; +<em>object</em>.protocol = <em>string</em>; +</pre> + +<h3 id="Value" name="Value">値</h3> + +<p>{{domxref("USVString")}}。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<pre class="brush: js">var url = new URL('https://developer.mozilla.org/en-US/docs/Web/API/URL/protocol'); +var result = url.protocol; // 戻り値: "https:" +</pre> + +<h2 id="Specifications" name="Specifications">仕様</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">仕様</th> + <th scope="col">状態</th> + <th scope="col">コメント</th> + </tr> + <tr> + <td>{{SpecName('URL', '#dom-url-protocol', 'protocol')}}</td> + <td>{{Spec2('URL')}}</td> + <td>初期定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + + + +<p>{{Compat("api.URL.protocol")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{domxref("URL")}} インターフェイスに属します。</li> +</ul> diff --git a/files/ja/web/api/url/revokeobjecturl/index.html b/files/ja/web/api/url/revokeobjecturl/index.html new file mode 100644 index 0000000000..f9ce5f6d1c --- /dev/null +++ b/files/ja/web/api/url/revokeobjecturl/index.html @@ -0,0 +1,75 @@ +--- +title: URL.revokeObjectURL() +slug: Web/API/URL/revokeObjectURL +tags: + - API + - DOM + - Method + - URL + - URL API + - revokeObjectURL +translation_of: Web/API/URL/revokeObjectURL +--- +<div>{{ApiRef("URL")}}</div> + +<p><span class="seoSummary"><strong><code>URL.revokeObjectURL()</code></strong> 静的メソッドは、以前に {{domxref("URL.createObjectURL()") }} を呼び出して生成された既存のオブジェクト URL を解放します。</span> オブジェクト URL を使い終わったら、このメソッドを呼び出して、ファイルへの参照をこれ以上保持しないようにブラウザーに知らせます。</p> + +<p>{{AvailableInWorkers}}</p> + +<div class="note"> +<p><strong>注</strong>: このメソッドは、{{domxref("Blob")}} インターフェイスのライフサイクルの問題とリークの可能性があるため、サービスワーカーからは利用できません。</p> +</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox"><em>window</em>.URL.revokeObjectURL(<em>objectURL</em>); +</pre> + +<h3 id="Parameters" name="Parameters">パラメーター</h3> + +<dl> + <dt><code>objectURL </code></dt> + <dd>以前に {{domxref("URL.createObjectURL", "createObjectURL()") }} を呼び出して生成されたオブジェクト URL を表す {{domxref("DOMString")}}。</dd> +</dl> + +<h3 id="Return_value" name="Return_value">戻り値</h3> + +<p>無効。</p> + +<ul> +</ul> + +<h2 id="Examples" name="Examples">例</h2> + +<p><a href="/ja/docs/Web/API/File/Using_files_from_web_applications#Example:_Using_object_URLs_to_display_images">オブジェクト URL で画像を表示</a>を参照してください。</p> + +<h2 id="Specification" name="Specification">仕様</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">仕様</th> + <th scope="col">状態</th> + <th scope="col">コメント</th> + </tr> + <tr> + <td>{{SpecName('File API', '#dfn-revokeObjectURL', 'revokeObjectURL()')}}</td> + <td>{{Spec2('File API')}}</td> + <td>初期定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + + + +<p>{{Compat("api.URL.revokeObjectURL")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li><a href="/ja/docs/Web/API/File/Using_files_from_web_applications">Web アプリケーションからファイルを扱う</a></li> + <li><a href="/ja/docs/Web/API/File/Using_files_from_web_applications#Example:_Using_object_URLs_to_display_images">オブジェクト URL で画像を表示</a></li> + <li>{{domxref("URL.createObjectURL()") }}</li> +</ul> diff --git a/files/ja/web/api/url/search/index.html b/files/ja/web/api/url/search/index.html new file mode 100644 index 0000000000..c913dfcc2f --- /dev/null +++ b/files/ja/web/api/url/search/index.html @@ -0,0 +1,62 @@ +--- +title: URL.search +slug: Web/API/URL/search +tags: + - API + - Property + - Reference + - Search + - URL +translation_of: Web/API/URL/search +--- +<div>{{ApiRef("URL API")}}</div> + +<p><span class="seoSummary">{{domxref("URL")}} インターフェイスの <strong><code>search</code></strong> プロパティは、<em>クエリー文字列</em>とも呼ばれる検索文字列、つまり <code>'?'</code> とその後に続く URL のパラメーターを含む {{domxref("USVString")}} です。</span></p> + +<p>最新のブラウザーでは {{domxref("URL.searchParams")}} プロパティを提供して、クエリー文字列からパラメーターを簡単に解析できるようにしています。</p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate">const <em>searchParams</em> = <em>object</em>.search +<em>url</em>.search = <em>newSearchParams</em></pre> + +<h3 id="Value" name="Value">値</h3> + +<p>{{domxref("USVString")}}。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<pre class="brush: js notranslate">const url = new URL('https://developer.mozilla.org/ja/docs/Web/API/URL/search?q=123'); +console.log(url.search); // 戻り値: "?q=123" +</pre> + +<h2 id="Specifications" name="Specifications">仕様</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">仕様</th> + <th scope="col">状態</th> + <th scope="col">コメント</th> + </tr> + <tr> + <td>{{SpecName('URL', '#dom-url-search', 'URL.search')}}</td> + <td>{{Spec2('URL')}}</td> + <td>初期定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + + + +<p>{{Compat("api.URL.search")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{domxref("URL")}} インターフェイスに属します。</li> +</ul> diff --git a/files/ja/web/api/url/searchparams/index.html b/files/ja/web/api/url/searchparams/index.html new file mode 100644 index 0000000000..8c8b04009f --- /dev/null +++ b/files/ja/web/api/url/searchparams/index.html @@ -0,0 +1,58 @@ +--- +title: URL.searchParams +slug: Web/API/URL/searchParams +tags: + - API + - Property + - Read-only + - Reference + - URL + - URLSearchParameter + - URLSearchParams + - searchParams +translation_of: Web/API/URL/searchParams +--- +<div>{{APIRef("URL API")}}</div> + +<p><span class="seoSummary">{{domxref("URL")}} インターフェイスの <strong><code>searchParams</code></strong> 読み取り専用プロパティは、URL に含まれる GET デコードされたクエリー引数へのアクセスを可能にする {{domxref("URLSearchParams")}} オブジェクトを返します。</span></p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox">var urlSearchParams = URL.searchParams;</pre> + +<h3 id="Value" name="Value">値</h3> + +<p>{{domxref("URLSearchParams")}} オブジェクト。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<p>ページの URL が <code>https://example.com/?name=Jonathan%20Smith&age=18</code> の場合、次を使用して 'name' および 'age' パラメーターを解析できます。</p> + +<pre class="brush: js">let params = (new URL(document.location)).searchParams; +let name = params.get('name'); // 文字列 "Jonathan Smith" です。 +let age = parseInt(params.get('age')); // 数値 18 です。</pre> + +<h2 id="Specifications" name="Specifications">仕様</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">仕様</th> + <th scope="col">状態</th> + <th scope="col">コメント</th> + </tr> + <tr> + <td>{{SpecName('URL', '#dom-url-searchparams', 'searchParams')}}</td> + <td>{{Spec2('URL')}}</td> + <td>初期定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + + + +<p>{{Compat("api.URL.searchParams")}}</p> diff --git a/files/ja/web/api/url/tojson/index.html b/files/ja/web/api/url/tojson/index.html new file mode 100644 index 0000000000..4b9af2c147 --- /dev/null +++ b/files/ja/web/api/url/tojson/index.html @@ -0,0 +1,60 @@ +--- +title: URL.toJSON() +slug: Web/API/URL/toJSON +tags: + - API + - Method + - Reference + - URL + - toJSON + - toJSON() +translation_of: Web/API/URL/toJSON +--- +<div>{{APIRef("URL API")}}</div> + +<p><span class="seoSummary">{{domxref("URL")}} インターフェイスの <strong><code>toJSON()</code></strong> メソッドは、URL のシリアル化されたバージョンを含む {{domxref("USVString")}} を返しますが、実際には {{domxref("URL.toString()")}} と同じ効果があるようです。</span></p> + +<p>(訳注:このメソッドは、{{jsxref("JSON.stringify()")}} メソッドが、このメソッドを持つオブジェクトを JSON 文字列に変換するために使います。)</p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox">json = url.toJSON();</pre> + +<h3 id="Parameters" name="Parameters">パラメーター</h3> + +<p>なし。</p> + +<h3 id="Return_value" name="Return_value">戻り値</h3> + +<p>{{domxref("USVString")}}。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<pre><span class="message-body-wrapper"><span class="message-flex-body"><span class="devtools-monospace message-body"><span class="cm-keyword">const</span> <span class="cm-def">url</span> <span class="cm-operator">=</span> <span class="cm-keyword">new</span> <span class="cm-variable">URL</span>(<span class="cm-string">"https://developer.mozilla.org/en-US/docs/Web/API/URL/toString"</span>); +<span class="cm-variable">url</span>.<span class="cm-property">toJSON</span>()</span></span></span> +</pre> + +<h2 id="Specifications" name="Specifications">仕様</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">仕様</th> + <th scope="col">状態</th> + <th scope="col">コメント</th> + </tr> + <tr> + <td>{{SpecName('URL', '#dom-url-tojson', 'toJSON()')}}</td> + <td>{{Spec2('URL')}}</td> + <td>初期定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + + + +<p>{{Compat("api.URL.toJSON")}}</p> diff --git a/files/ja/web/api/url/tostring/index.html b/files/ja/web/api/url/tostring/index.html new file mode 100644 index 0000000000..7508410da6 --- /dev/null +++ b/files/ja/web/api/url/tostring/index.html @@ -0,0 +1,64 @@ +--- +title: URL.toString() +slug: Web/API/URL/toString +tags: + - API + - Method + - Reference + - Stringifier + - URL + - toString() +translation_of: Web/API/URL/toString +--- +<div>{{ApiRef("URL API")}}</div> + +<p><code>URL.toString()</code> 文字列化メソッドは、URL 全体を含む {{domxref("USVString")}} を返します。 これは事実上、{{domxref("URL.href")}} の読み取り専用バージョンです。</p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox"><em>string</em> = <em>url</em>.toString();</pre> + +<h3 id="Parameters" name="Parameters">パラメーター</h3> + +<p>なし。</p> + +<h3 id="Return_value" name="Return_value">戻り値</h3> + +<p>{{domxref("USVString")}}。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<pre class="brush: js"><span class="message-body-wrapper"><span class="message-flex-body"><span class="devtools-monospace message-body"><span class="cm-keyword">const</span> <span class="cm-def">url</span> <span class="cm-operator">=</span> <span class="cm-keyword">new</span> <span class="cm-variable">URL</span>(<span class="cm-string">"https://developer.mozilla.org/en-US/docs/Web/API/URL/toString"</span>); +<span class="cm-variable">url</span>.<span class="cm-property">toString</span>() // URL を文字列として返します</span></span></span> +</pre> + +<h2 id="Specifications" name="Specifications">仕様</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">仕様</th> + <th scope="col">状態</th> + <th scope="col">コメント</th> + </tr> + <tr> + <td>{{SpecName('URL', '#URL-stringification-behavior', 'stringifier')}}</td> + <td>{{Spec2('URL')}}</td> + <td>初期定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + + + +<p>{{Compat("api.URL.toString")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{domxref("URL")}} インターフェイスに属します。</li> +</ul> diff --git a/files/ja/web/api/url/url/index.html b/files/ja/web/api/url/url/index.html new file mode 100644 index 0000000000..8e29db898c --- /dev/null +++ b/files/ja/web/api/url/url/index.html @@ -0,0 +1,105 @@ +--- +title: URL() +slug: Web/API/URL/URL +tags: + - API + - Constructor + - Reference + - URL + - URL API +translation_of: Web/API/URL/URL +--- +<div>{{APIRef("URL API")}}</div> + +<p><span class="seoSummary"><strong><code>URL()</code></strong> コンストラクターは、パラメーターによって定義された URL を表す、新しく生成された {{domxref("URL")}} オブジェクトを返します。</span></p> + +<p>与えられたベース URL または結果の URL が有効な URL でない場合、JavaScript の {{jsxref("TypeError")}} 例外がスローされます。</p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox"><em>url</em> = new URL(<em>url</em>, [<em>base</em>]) +</pre> + +<h3 id="Parameters" name="Parameters">パラメーター</h3> + +<dl> + <dt><code>url</code></dt> + <dd>絶対 URL または相対 URL を表す {{domxref("USVString")}}。<code>url</code> が相対 URL の場合、<code>base</code> は必須であり、ベース URL として使用されます。<code>url</code> が絶対 URL の場合、指定された <code>base</code> は無視されます。</dd> + <dt><code>base</code><em> </em>{{optional_inline}}</dt> + <dd><code>url</code> が相対 URL の場合に使用するベース URL を表す {{domxref("USVString")}}。 指定しない場合のデフォルトは <code>''</code> です。</dd> +</dl> + +<div class="note"> +<p><strong>注</strong>: 既存の {{domxref("URL")}} オブジェクトを <code>base</code> に使用することも可能で、オブジェクトの {{domxref("URL.href","href")}} プロパティにそれ自体を文字列化します。</p> +</div> + +<h3 id="Exceptions" name="Exceptions">例外</h3> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">例外</th> + <th scope="col">説明</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{jsxref("TypeError")}}</td> + <td><code>url</code> (絶対 URL の場合) または <code>base</code> + <code>url</code> (相対 URL の場合) が、有効な URL ではありません。</td> + </tr> + </tbody> +</table> + +<h2 id="Examples" name="Examples">例</h2> + +<pre class="brush: js">// ベース URL +var m = 'https://developer.mozilla.org'; +var a = new URL("/", m); // => 'https://developer.mozilla.org/' +var b = new URL(m); // => 'https://developer.mozilla.org/' + + new URL('en-US/docs', b); // => 'https://developer.mozilla.org/en-US/docs' +var d = new URL('/en-US/docs', b); // => 'https://developer.mozilla.org/en-US/docs' + new URL('/en-US/docs', d); // => 'https://developer.mozilla.org/en-US/docs' + new URL('/en-US/docs', a); // => 'https://developer.mozilla.org/en-US/docs' + + new URL('/en-US/docs', "https://developer.mozilla.org/fr-FR/toto"); + // => 'https://developer.mozilla.org/en-US/docs' + + new URL('/en-US/docs', ''); // '' は有効な URL ではないため、TypeError 例外が発生します + new URL('/en-US/docs'); // '/en-US/docs' は有効な URL ではないため、TypeError 例外が発生します + new URL('http://www.example.com', ); // => 'http://www.example.com/' + new URL('http://www.example.com', b); // => 'http://www.example.com/' + + new URL("//foo.com", "https://example.com") // => 'https://foo.com' (相対 URL を参照) +</pre> + +<h2 id="Specification" name="Specification">仕様</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">仕様</th> + <th scope="col">状態</th> + <th scope="col">コメント</th> + </tr> + <tr> + <td>{{SpecName('URL', '#constructors', 'URL.URL()')}}</td> + <td>{{Spec2('URL')}}</td> + <td>初期定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + + + +<p>{{Compat("api.URL.URL")}}</p> + +<h2 id="See_also" name="See_also">関連項目</h2> + +<ul> + <li>所属しているインターフェース: {{domxref("URL")}}。</li> +</ul> diff --git a/files/ja/web/api/url/username/index.html b/files/ja/web/api/url/username/index.html new file mode 100644 index 0000000000..0171d64d92 --- /dev/null +++ b/files/ja/web/api/url/username/index.html @@ -0,0 +1,61 @@ +--- +title: URL.username +slug: Web/API/URL/username +tags: + - API + - Property + - Reference + - URL + - username +translation_of: Web/API/URL/username +--- +<div>{{ApiRef("URL API")}}</div> + +<p><span class="seoSummary">{{domxref("URL")}} インターフェイスの <strong><code>username</code></strong> プロパティは、ドメイン名の前に指定されたユーザー名を含む {{domxref("USVString")}} です。</span></p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox"><em>string</em> = <em>object</em>.username; +<em>object</em>.username = <em>string</em>; +</pre> + +<h3 id="Value" name="Value">値</h3> + +<p>{{domxref("USVString")}}。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<pre class="brush: js">var url = new URL("https://anonymous:flabada@developer.mozilla.org/en-US/docs/Web/API/URL/username"); +var user = url.username; // 戻り値: 'anonymous' +</pre> + +<h2 id="Specifications" name="Specifications">仕様</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">仕様</th> + <th scope="col">状態</th> + <th scope="col">コメント</th> + </tr> + <tr> + <td>{{SpecName('URL', '#dom-url-username', 'username')}}</td> + <td>{{Spec2('URL')}}</td> + <td>初期定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + + + +<p>{{Compat("api.URL.username")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{domxref("URL")}} インターフェイスに属します。</li> +</ul> |