Skip to content

Commit

Permalink
Merge branch 'main' into content-sync-ja
Browse files Browse the repository at this point in the history
  • Loading branch information
mfuji09 authored Aug 27, 2024
2 parents d33c6cd + 3f19c1c commit ed7f32c
Show file tree
Hide file tree
Showing 139 changed files with 731 additions and 818 deletions.
9 changes: 6 additions & 3 deletions files/es/_redirects.txt
Original file line number Diff line number Diff line change
Expand Up @@ -2198,9 +2198,12 @@
/es/docs/Web/HTML/microformatos /es/docs/Web/HTML/microformats
/es/docs/Web/HTML/Índice /es/docs/Web/HTML
/es/docs/Web/HTTP/Access_control_CORS /es/docs/Web/HTTP/CORS
/es/docs/Web/HTTP/Basics_of_HTTP/Data_URIs /es/docs/Web/HTTP/Basics_of_HTTP/Data_URLs
/es/docs/Web/HTTP/Basics_of_HTTP/Datos_URIs /es/docs/Web/HTTP/Basics_of_HTTP/Data_URLs
/es/docs/Web/HTTP/Basics_of_HTTP/Identificación_recursos_en_la_Web /es/docs/Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web
/es/docs/Web/HTTP/Basics_of_HTTP/Choosing_between_www_and_non-www_URLs /es/docs/Web/URI/Authority/Choosing_between_www_and_non-www_URLs
/es/docs/Web/HTTP/Basics_of_HTTP/Data_URIs /es/docs/Web/URI/Schemes/data
/es/docs/Web/HTTP/Basics_of_HTTP/Data_URLs /es/docs/Web/URI/Schemes/data
/es/docs/Web/HTTP/Basics_of_HTTP/Datos_URIs /es/docs/Web/URI/Schemes/data
/es/docs/Web/HTTP/Basics_of_HTTP/Identificación_recursos_en_la_Web /es/docs/orphaned/Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web
/es/docs/Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web /es/docs/orphaned/Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web
/es/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Lista_completa_de_tipos_MIME /es/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Common_types
/es/docs/Web/HTTP/Gestion_de_la_conexion_en_HTTP_1.x /es/docs/Web/HTTP/Connection_management_in_HTTP_1.x
/es/docs/Web/HTTP/Peticiones_condicionales /es/docs/Web/HTTP/Conditional_requests
Expand Down
24 changes: 12 additions & 12 deletions files/es/_wikihistory.json
Original file line number Diff line number Diff line change
Expand Up @@ -9424,22 +9424,10 @@
"cissoid"
]
},
"Web/HTTP/Basics_of_HTTP/Choosing_between_www_and_non-www_URLs": {
"modified": "2019-03-18T21:22:07.450Z",
"contributors": ["Adorta4", "carlosgocereceda"]
},
"Web/HTTP/Basics_of_HTTP/Data_URLs": {
"modified": "2019-03-23T22:24:54.977Z",
"contributors": ["Sergio_Gonzalez_Collado", "AzazelN28", "uclides"]
},
"Web/HTTP/Basics_of_HTTP/Evolution_of_HTTP": {
"modified": "2019-03-23T22:10:11.567Z",
"contributors": ["Sergio_Gonzalez_Collado", "ChrisMHM"]
},
"Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web": {
"modified": "2019-03-23T22:24:51.387Z",
"contributors": ["DaniNz", "Sergio_Gonzalez_Collado", "ChrisMHM", "uclides"]
},
"Web/HTTP/Basics_of_HTTP/MIME_types": {
"modified": "2019-11-18T08:03:54.325Z",
"contributors": [
Expand Down Expand Up @@ -13449,6 +13437,14 @@
"diegogaysaez"
]
},
"Web/URI/Authority/Choosing_between_www_and_non-www_URLs": {
"modified": "2019-03-18T21:22:07.450Z",
"contributors": ["Adorta4", "carlosgocereceda"]
},
"Web/URI/Schemes/data": {
"modified": "2019-03-23T22:24:54.977Z",
"contributors": ["Sergio_Gonzalez_Collado", "AzazelN28", "uclides"]
},
"Web/XML/Parsing_and_serializing_XML": {
"modified": "2019-03-23T22:10:22.365Z",
"contributors": ["FenixAlive"]
Expand Down Expand Up @@ -15330,6 +15326,10 @@
"modified": "2019-03-23T22:46:15.359Z",
"contributors": ["juanbrujo", "raecillacastellana", "vltamara"]
},
"orphaned/Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web": {
"modified": "2019-03-23T22:24:51.387Z",
"contributors": ["DaniNz", "Sergio_Gonzalez_Collado", "ChrisMHM", "uclides"]
},
"orphaned/Web/JavaScript/Reference/Errors/Undefined_prop": {
"modified": "2020-03-12T19:47:46.684Z",
"contributors": ["antixsuperstar"]
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: Identificación de recursos web
slug: Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web
slug: orphaned/Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web
original_slug: Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web
---

{{HTTPSidebar}}
Expand Down
67 changes: 67 additions & 0 deletions files/es/web/javascript/reference/global_objects/map/set/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
---
title: Map.prototype.set()
slug: Web/JavaScript/Reference/Global_Objects/Map/set
l10n:
sourceCommit: 3cfd663738e9963157d90f359789d675a6662ec2
---

{{JSRef}}

El método **`set()`** de las instancias {{jsxref("Map")}} agrega o actualiza una entrada en este _map_ con la llave y valor especificados.

{{EmbedInteractiveExample("pages/js/map-prototype-set.html")}}

## Sintaxis

```js-nolint
set(key, value)
```

### Parámetros

- `key`
- : La llave del elemento que se va a agregar al objeto `Map`. La llave puede ser cualquiera de los [tipos de dato de JavaScript](/es/docs/Web/JavaScript/Data_structures) (cualquier [valor primitivo](/es/docs/Web/JavaScript/Data_structures#valores_primitivos) o cualquier tipo de [objeto JavaScript](/es/docs/Web/JavaScript/Data_structures#objetos)).
- `value`
- : El valor de el elemento que se va a agregar al objeto `Map`. El valor puede ser cualquiera de los [tipos de dato de JavaScript](/es/docs/Web/JavaScript/Data_structures) (cualquier [valor primitivo](/es/docs/Web/JavaScript/Data_structures#valores_primitivos) o cualquier tipo de [objeto JavaScript](/es/docs/Web/JavaScript/Data_structures#objetos)).

### Valor devuelto

El objeto `Map`.

## Ejemplos

### Usando set()

```js
const myMap = new Map();

// Agrega nuevos elementos a el map
myMap.set("bar", "foo");
myMap.set(1, "foobar");

// Actualiza un elemento en el map
myMap.set("bar", "baz");
```

### Usando set() encadenandolo

Ya que el método `set()` regresa el mismo objeto `Map`, puedes encadenar la llamada al método como se muestra acontinuación:

```js
// Agrega nuevos elementos al map, encadenando las llamadas.
myMap.set("bar", "foo").set(1, "foobar").set(2, "baz");
```

## Especificaciones

{{Specifications}}

## Compatibilidad con navegadores

{{Compat}}

## Véase también

- {{jsxref("Map")}}
- {{jsxref("Map.prototype.get()")}}
- {{jsxref("Map.prototype.has()")}}
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: Elección entre www y no-www URLs
slug: Web/HTTP/Basics_of_HTTP/Choosing_between_www_and_non-www_URLs
slug: Web/URI/Authority/Choosing_between_www_and_non-www_URLs
original_slug: Web/HTTP/Basics_of_HTTP/Choosing_between_www_and_non-www_URLs
---

{{HTTPSidebar}}
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: Datos URIs
slug: Web/HTTP/Basics_of_HTTP/Data_URLs
slug: Web/URI/Schemes/data
original_slug: Web/HTTP/Basics_of_HTTP/Data_URLs
---

{{HTTPSidebar}}
Expand Down
113 changes: 113 additions & 0 deletions files/ja/web/uri/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,113 @@
---
title: URI
slug: Web/URI
l10n:
sourceCommit: 6b730e3cfdf0f51940b44efa71bd59c84ce76e71
---

{{QuickLinksWithSubpages("/ja/docs/Web/URI")}}

**Uniform Resource Identifiers (統一リソース識別子、URI)** は、ウェブ上の「リソース」を識別するために使用されます。これらは一般的に [HTTP](/ja/docs/Web/HTTP) リクエストの対象として使用され、その場合、URI は文書、写真、バイナリーデータなどの物理的なリソースの場所を表します。URI は、HTML の `<a>` リンクの [`href`](/ja/docs/Web/HTML/Element/a#href) など、他の場所で使用された場合、リソースを取得する以外の動作を起動するために使用することもできます。

## URL と URN

### URL

URI の形で最も一般的に使用されているものは、Uniform Resource Locator ({{Glossary("URL")}}) であり、これは「ウェブアドレス」として知られています。

```url
https://developer.mozilla.org
https://developer.mozilla.org/ja/docs/Learn/
https://developer.mozilla.org/ja/search?q=URL
```

これらの URL のいずれかをブラウザーのアドレスバーに入力すると、関連するページ(リソース)を読み込むよう指示することができます。

URL は、さまざまな部分で構成されており、必須のものと省略可能なものがあります。例えば、より複雑な例としては、次のようなものがあります。

```url
http://www.example.com:80/path/to/myfile.html?key1=value1&key2=value2#SomewhereInTheDocument
```

### URN

Uniform Resource Name (統一リソース名、URN) は、特定の名前空間において名前でリソースを識別する URI です。

```url
urn:isbn:9780141036144
urn:ietf:rfc:7230
```

これら 2 つの URN は次のものに対応します。

- George Orwell の書籍 Nineteen Eighty-Four
- IETF 仕様書 7230、 Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing

## Uniform Resource Identifiers (URI) の構文

以下の URL をその部品に分解します。

```url
http://www.example.com:80/path/to/myfile.html?key1=value1&key2=value2#SomewhereInTheDocument
```

### スキーム

![Protocol]([email protected])

`http://` は URL の[スキーム](/ja/docs/Web/URI/Schemes)です。これは、ブラウザーが使用すべきプロトコルを示します。通常、HTTP プロトコルまたは安全なバージョンである HTTPS になります。ウェブではこれら 2 つのうちひとつを必要としますが、ブラウザーは `mailto:` (メールクライアントを開く)やファイル転送を扱う `ftp:` といったほかのプロトコルの扱い方も知っていますので、このようなプロトコルが現れても驚かないでください。[スキーム](/ja/docs/Web/URI/Schemes)のリファレンスでは、最も一般的なスキームの一覧と、その一部のドキュメントが提供されています。

{{Glossary("HTML")}} コンテンツで URL を使用する際には、一般的にこれらの URL スキームのうちのいくつかのみを使用します。サブリソース(つまり、より大きな文書の一部として読み込まれるファイル)を参照する際には、HTTP と HTTPS のスキームのみを使用します。セキュリティ上の理由から、ブラウザーではサブリソースの読み込みに FTP を使用する対応が徐々に除去されるようになっています。

FTP は現在でも最上位のレベルでは受け入れられます(ブラウザーの URL バーに直接入力したり、リンクの対象とするな))。ただし、一部のブラウザーでは、FTP コンテンツの読み込みを別のアプリケーションに委任する場合があります。

### オーソリティ

URI の[オーソリティ](/ja/docs/Web/URI/Authority)は、ユーザー情報(オプションで通常は指定しない)、ホスト名、ポートで構成されます。

![ドメイン名]([email protected])

`www.example.com` は、名前空間を統制するドメイン名またはオーソリティです。これは、どのウェブサーバーがリクエストされているかを示します。代わりに {{Glossary("IP address","IP アドレス")}}を直接使用することもできますが、利便性が低いためウェブではあまり使用されません。

![ポート番号]([email protected])

`:80` は URL のポート番号です。これはウェブサーバー内のリソースへアクセスするために使用する、技術上の「出入口」です。ウェブサーバーがリソースへのアクセスを受け入れるために HTTP プロトコルの標準ポート(HTTP では 80、HTTPS では 443)を使用している場合、通常はポートを省略します。それ以外の場合は、ポートが必須です。

### パス

- ![ファイルへのパス]([email protected])

- : `/path/to/myfile.html` は、ウェブサーバー内にあるリソースのパスです。初期のウェブではこのようなパスが、ウェブサーバー内の物理的なファイルの場所を表していました。現代のパスはたいてい物理的な実情と関係がない、ウェブサーバーによって制御される抽象的なものになっています。

### クエリー

![引数]([email protected])

`?key1=value1&key2=value2` は、ウェブサーバーに提供する追加の引数です。この引数は `&` 記号で区切られた、キーと値のペアのリストです。ウェブサーバーは、ユーザーへリソースを返す前に追加の処理を行うために、この引数を使用できます。それぞれのウェブサーバーは引数について独自の規則を持っており、特定のウェブサーバーが引数を扱う方法を知るために唯一信頼できる方法は、ウェブサーバーの所有者に尋ねることです。

### フラグメント

- ![アンカー]([email protected])

- : `#SomewhereInTheDocument` は、リソース自体の別の場所へのアンカーです。アンカーはリソース内の一種の「ブックマーク」を表しており、「ブックマーク」地点にあるコンテンツを表示するようにブラウザーへ指示を与えます。例えば HTML 文書では、ブラウザーはアンカーが定義されている位置にスクロールします。動画や音声の文書では、ブラウザーはアンカーが示す位置への移動を試みます。 # より後の部分はフラグメント識別子としても知られており、リクエストでサーバーには送信されないことは注目に値します。

[テキストフラグメント](/ja/docs/Web/URI/Fragment/Text_fragments)という特別な機能があり、テキストコンテンツで識別されるウェブページの特定の部分にリンクすることができます。

##

```url
https://developer.mozilla.org/ja/docs/Learn
tel:+1-816-555-1212
[email protected]:mdn/browser-compat-data.git
ftp://example.org/resource.txt
urn:isbn:9780141036144
mailto:[email protected]
```

## 仕様書

{{Specifications}}

## 関連情報

- [URL とは何か](/ja/docs/Learn/Common_questions/Web_mechanics/What_is_a_URL)
12 changes: 8 additions & 4 deletions files/zh-cn/_redirects.txt
Original file line number Diff line number Diff line change
Expand Up @@ -2423,9 +2423,11 @@
/zh-CN/docs/Web/HTML/动作 /zh-CN/docs/Glossary/Speculative_parsing
/zh-CN/docs/Web/HTML/属性 /zh-CN/docs/Web/HTML/Attributes
/zh-CN/docs/Web/HTTP/Access_control_CORS /zh-CN/docs/Web/HTTP/CORS
/zh-CN/docs/Web/HTTP/Basics_of_HTTP/Data_URIs /zh-CN/docs/Web/HTTP/Basics_of_HTTP/Data_URLs
/zh-CN/docs/Web/HTTP/Basics_of_HTTP/Choosing_between_www_and_non-www_URLs /zh-CN/docs/Web/URI/Authority/Choosing_between_www_and_non-www_URLs
/zh-CN/docs/Web/HTTP/Basics_of_HTTP/Data_URIs /zh-CN/docs/Web/URI/Schemes/data
/zh-CN/docs/Web/HTTP/Basics_of_HTTP/Data_URLs /zh-CN/docs/Web/URI/Schemes/data
/zh-CN/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Complete_list_of_MIME_types /zh-CN/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Common_types
/zh-CN/docs/Web/HTTP/Basics_of_HTTP/选择_www_或非_www_URL_作为域名 /zh-CN/docs/Web/HTTP/Basics_of_HTTP/Choosing_between_www_and_non-www_URLs
/zh-CN/docs/Web/HTTP/Basics_of_HTTP/选择_www_或非_www_URL_作为域名 /zh-CN/docs/Web/URI/Authority/Choosing_between_www_and_non-www_URLs
/zh-CN/docs/Web/HTTP/CORS/Errors/CORS错误允许凭证 /zh-CN/docs/Web/HTTP/CORS/Errors/CORSMIssingAllowCredentials
/zh-CN/docs/Web/HTTP/Caching_FAQ /zh-CN/docs/Web/HTTP/Caching
/zh-CN/docs/Web/HTTP/Content_negotiation/Accept_默认值 /zh-CN/docs/Web/HTTP/Content_negotiation/List_of_default_Accept_values
Expand Down Expand Up @@ -2460,12 +2462,13 @@
/zh-CN/docs/Web/HTTP/Link_prefetching_FAQ /zh-CN/docs/Glossary/Prefetch
/zh-CN/docs/Web/HTTP/Proxy_servers_and_tunneling/Proxy_Auto-Configuration_(PAC)_file /zh-CN/docs/Web/HTTP/Proxy_servers_and_tunneling/Proxy_Auto-Configuration_PAC_file
/zh-CN/docs/Web/HTTP/Public_Key_Pinning /zh-CN/docs/Web/Security/Certificate_Transparency
/zh-CN/docs/Web/HTTP/Resources_and_URIs /zh-CN/docs/Web/HTTP/Basics_of_HTTP/MIME_types
/zh-CN/docs/Web/HTTP/Response_codes /zh-CN/docs/Web/HTTP/Status
/zh-CN/docs/Web/HTTP/Response_codes/100 /zh-CN/docs/Web/HTTP/Status/100
/zh-CN/docs/Web/HTTP/Response_codes/204 /zh-CN/docs/Web/HTTP/Status/204
/zh-CN/docs/Web/HTTP/Response_codes/501 /zh-CN/docs/Web/HTTP/Status/501
/zh-CN/docs/Web/HTTP/X-Frame-Options /zh-CN/docs/Web/HTTP/Headers/X-Frame-Options
/zh-CN/docs/Web/HTTP/data_URIs /zh-CN/docs/Web/HTTP/Basics_of_HTTP/Data_URLs
/zh-CN/docs/Web/HTTP/data_URIs /zh-CN/docs/Web/URI/Schemes/data
/zh-CN/docs/Web/HTTP/消息 /zh-CN/docs/Web/HTTP/Messages
/zh-CN/docs/Web/HTTP/策略特征 /zh-CN/docs/Web/HTTP/Permissions_Policy
/zh-CN/docs/Web/HTTP/缓存_FAQ /zh-CN/docs/Web/HTTP/Caching
Expand Down Expand Up @@ -2754,6 +2757,7 @@
/zh-CN/docs/Web/Security/Securing_your_site/Turning_off_form_autocompletion /zh-CN/docs/Web/Security/Practical_implementation_guides/Turning_off_form_autocompletion
/zh-CN/docs/Web/Security/传输层安全协议 /zh-CN/docs/Web/Security/Transport_Layer_Security
/zh-CN/docs/Web/Security/子资源完整性 /zh-CN/docs/Web/Security/Subresource_Integrity
/zh-CN/docs/Web/Text_fragments /zh-CN/docs/Web/URI/Fragment/Text_fragments
/zh-CN/docs/Web/WEB_API_---js /zh-CN/docs/Web/API
/zh-CN/docs/Web/WebGL /zh-CN/docs/Web/API/WebGL_API
/zh-CN/docs/Web/WebGL/Adding_2D_content_to_a_WebGL_context /zh-CN/docs/Web/API/WebGL_API/Tutorial/Adding_2D_content_to_a_WebGL_context
Expand Down Expand Up @@ -2792,7 +2796,7 @@
/zh-CN/docs/XPath-840092-dup /zh-CN/docs/Web/XPath
/zh-CN/docs/XSLT /zh-CN/docs/Web/XSLT
/zh-CN/docs/d_temp /zh-CN/docs/Web/API/Document
/zh-CN/docs/data_URIs /zh-CN/docs/Web/HTTP/Basics_of_HTTP/Data_URLs
/zh-CN/docs/data_URIs /zh-CN/docs/Web/URI/Schemes/data
/zh-CN/docs/en /en-US/
/zh-CN/docs/keypress /zh-CN/docs/Web/API/Element/keypress_event
/zh-CN/docs/learn/Accessibility/CSS和JavaScript /zh-CN/docs/Learn/Accessibility/CSS_and_JavaScript
Expand Down
Loading

0 comments on commit ed7f32c

Please sign in to comment.