-
Notifications
You must be signed in to change notification settings - Fork 8.1k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge branch 'main' into content-sync-ja
- Loading branch information
Showing
139 changed files
with
731 additions
and
818 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
3 changes: 2 additions & 1 deletion
3
...identifying_resources_on_the_web/index.md → ...identifying_resources_on_the_web/index.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
67 changes: 67 additions & 0 deletions
67
files/es/web/javascript/reference/global_objects/map/set/index.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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()")}} |
3 changes: 2 additions & 1 deletion
3
...ing_between_www_and_non-www_urls/index.md → ...ing_between_www_and_non-www_urls/index.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
3 changes: 2 additions & 1 deletion
3
...eb/http/basics_of_http/data_urls/index.md → files/es/web/uri/schemes/data/index.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.