Skip to content

ru: Convert noteblocks to GFM alerts (part 2) #23006

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 27 commits into from
Aug 10, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 0 additions & 2 deletions files/ru/web/api/extendableevent/waituntil/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,8 +13,6 @@ slug: Web/API/ExtendableEvent/waitUntil

Метод `waitUntil()` должен быть изначально вызван внутри колбэка события (_event callback_), но после этого он может быть вызван множество раз, до тех пор пока все промисы, переданные в него, не завершатся успешно.

> **Примечание:** Поведение описанное в параграфе выше, было исправлено в Firefix 43 (смотрите [Firefox bug 1180274](https://bugzil.la/1180274)).

## Синтаксис

```
Expand Down
3 changes: 2 additions & 1 deletion files/ru/web/api/fetch_api/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,8 @@ Fetch обеспечивает обобщённое определение об
- `fetch()` может получать межсайтовые куки-файлы; таким образом вы можете установить межсайтовую сессию используя `fetch`.
- `fetch()` не будет посылать куки-файлы, если только не указано `credentials: 'same-origin'`.

> **Примечание:** узнайте больше об использовании Fetch API на [Using Fetch](/ru/docs/Web/API/Fetch_API/Using_Fetch) и изучите концепции на [Fetch basic concepts](/ru/docs/Web/API/Fetch_API/Basic_concepts).
> [!NOTE]
> Узнайте больше об использовании Fetch API на [Using Fetch](/ru/docs/Web/API/Fetch_API/Using_Fetch) и изучите концепции на [Fetch basic concepts](/ru/docs/Web/API/Fetch_API/Basic_concepts).

### Прерывание выборки

Expand Down
4 changes: 0 additions & 4 deletions files/ru/web/api/fetch_api/using_fetch/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,6 @@ slug: Web/API/Fetch_API/Using_Fetch
- Promise возвращаемый вызовом `fetch()` **не перейдёт в состояние "отклонено" из-за ответа HTTP, который считается ошибкой**, даже если ответ HTTP 404 или 500. Вместо этого, он будет выполнен нормально (с значением false в статусе `ok` ) и будет отклонён только при сбое сети или если что-то помешало запросу выполниться.
- По умолчанию, `fetch` **не будет отправлять или получать cookie файлы** с сервера, в результате чего запросы будут осуществляться без проверки подлинности, что приведёт к неаутентифицированным запросам, если сайт полагается на проверку пользовательской сессии (для отправки cookie файлов в аргументе [init options](/ru/docs/Web/API/fetch#Parameters) должно быть задано значение свойства _credentials_ отличное от значения по умолчанию `omit`).

> **Примечание:** 25 августа 2017 г. в спецификации изменилось значение по умолчанию свойства _credentials_ на `same-origin`. Firefox применяет это изменение с версии 61.0b13.

Базовый запрос на получение данных действительно прост в настройке. Взгляните на следующий код:

```
Expand All @@ -32,8 +30,6 @@ fetch('http://example.com/movies.json')

Конечно, это просто HTTP-ответ, а не фактический JSON. Чтобы извлечь содержимое тела JSON из ответа, мы используем {{domxref("Body.json","json()")}} метод (определён миксином {{domxref("Body")}}, который реализован в объектах {{domxref("Request")}} и {{domxref("Response")}}.)

> **Примечание:** Миксин Body имеет подобные методы для извлечения других типов контента; см. раздел [Тело](#тело).

Fetch-запросы контролируются посредством директивы `connect-src` ([Content Security Policy](/ru/docs/Security/CSP/CSP_policy_directives)), а не директивой извлекаемых ресурсов.

### Установка параметров запроса
Expand Down
6 changes: 4 additions & 2 deletions files/ru/web/api/file_and_directory_entries_api/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,11 +9,13 @@ slug: Web/API/File_and_Directory_Entries_API

API доступа к файлам и директориям имитирует локальную файловую систему, в которой веб-приложения могут перемещаться и получать доступ к файлам. Вы можете разрабатывать приложения, которые читают, записывают и создают файлы и/или каталоги в виртуальной изолированной файловой системе.

> **Примечание:** Поскольку это нестандартный API, спецификация которого в настоящее время не входит в стандарт, важно помнить, что не все браузеры реализуют его, а те, которые поддерживают, могут реализовывать только небольшие его части. Дополнительные сведения в разделе [Browser compatibility](#browser_compatibility)
> [!NOTE]
> Поскольку это нестандартный API, спецификация которого в настоящее время не входит в стандарт, важно помнить, что не все браузеры реализуют его, а те, которые поддерживают, могут реализовывать только небольшие его части. Дополнительные сведения в разделе [Browser compatibility](#browser_compatibility)

Существуют два очень похожих API в зависимости от того, хотите ли вы асинхронного или синхронного поведения. Синхронный API предназначен для использования внутри {{domxref("Worker")}} и будет возвращать желаемые значения. Асинхронный API не будет блокировать выполнение кода, а API не будет возвращать значения; вместо этого вам нужно будет предоставить колбэк-функцию для обработки одного или нескольких ответов.

> **Предупреждение:** Firefox реализация File System API очень ограничена: не поддерживается создание файлов. Доступ к файлам осуществляется только через {{HTMLElement("input")}} элемент (см. так же {{domxref("HTMLInputElement")}}) или путём перетаскивания файла/папки ([drag and drop](/ru/docs/Web/API/HTML_Drag_and_Drop_API)). Firefox также не реализует синхронный API. Внимательно проверьте совместимость браузера для любой части API, которую вы используете. ( см. [Поддержка File System API в Firefox](/ru/docs/Web/API/File_and_Directory_Entries_API/Firefox_support))
> [!WARNING]
> Firefox реализация File System API очень ограничена: не поддерживается создание файлов. Доступ к файлам осуществляется только через {{HTMLElement("input")}} элемент (см. так же {{domxref("HTMLInputElement")}}) или путём перетаскивания файла/папки ([drag and drop](/ru/docs/Web/API/HTML_Drag_and_Drop_API)). Firefox также не реализует синхронный API. Внимательно проверьте совместимость браузера для любой части API, которую вы используете. ( см. [Поддержка File System API в Firefox](/ru/docs/Web/API/File_and_Directory_Entries_API/Firefox_support))

## Получение доступа к файловой системе

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,8 @@ var selectedFile = $("#input").get(0).files[0];
var selectedFile = $("#input")[0].files[0];
```

> **Примечание:** Ошибка "files is undefined" означает что был выбран не один HTML-элемент, а список элементов, возвращаемый jQuery. Необходимо уточнить, у какого именно элемента требуется вызвать метод "files"
> [!NOTE]
> Ошибка "files is undefined" означает что был выбран не один HTML-элемент, а список элементов, возвращаемый jQuery. Необходимо уточнить, у какого именно элемента требуется вызвать метод "files"

### Доступ к выбранным файлам через событие change

Expand Down
3 changes: 2 additions & 1 deletion files/ru/web/api/filelist/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,8 @@ slug: Web/API/FileList

Объект этого типа возвращается свойством {{HTMLElement("input")}} элемента, что позволяет получить список выбранных файлов из `<input type="file">`. Также используется для получения списка файлов, брошенных в область веб-контента (**Web content**) по средствам drag and drop API. Смотрите [DataTransfer](/ru/docs/DragDrop/DataTransfer) для детального понимания как это использовать.

> **Примечание:** До версии Gecko 1.9.2, input элемент поддерживает только один выбранный файл, это значит что FileList содержит только один файл. Начиная с Gecko 1.9.2, если input содержит атрибут multiple=true, то FileList может содержать несколько файлов.
> [!NOTE]
> До версии Gecko 1.9.2, input элемент поддерживает только один выбранный файл, это значит что FileList содержит только один файл. Начиная с Gecko 1.9.2, если input содержит атрибут multiple=true, то FileList может содержать несколько файлов.

## Использование FileList

Expand Down
5 changes: 3 additions & 2 deletions files/ru/web/api/filereader/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ slug: Web/API/FileReader

Объекты `File` можно получить через объект {{domxref("FileList")}}, который возвращается как результат при выборе файлов пользователем с помощью элемента {{HTMLElement("input")}}, через drag and drop из объекта {{domxref("DataTransfer")}}, или с помощью `mozGetAsFile()`, метода доступного в API элемента {{domxref("HTMLCanvasElement")}}.

> **Предупреждение:** Важное замечание: `FileReader` используется только для безопасным образом чтения содержимого файла из пользовательской (удалённой) системы. Его нельзя использовать для простого чтения файла по пути из файловой системы. Для чтения файла по пути в JavaScript следует использовать стандартное решение Ajax для чтения файла на стороне сервера с разрешение CORS при кроссдоменном чтении.
> **Предупреждение:** `FileReader` используется только для безопасным образом чтения содержимого файла из пользовательской (удалённой) системы. Его нельзя использовать для простого чтения файла по пути из файловой системы. Для чтения файла по пути в JavaScript следует использовать стандартное решение Ajax для чтения файла на стороне сервера с разрешение CORS при кроссдоменном чтении.

{{AvailableInWorkers}}

Expand Down Expand Up @@ -47,7 +47,8 @@ FileReader FileReader();
- {{domxref("FileReader.onprogress")}}
- : Обработчик для события {{event("progress")}}. Это событие срабатывает во время чтения данных из {{domxref("Blob")}}.

> **Примечание:** Замечание: т.к. `FileReader` унаследован от {{domxref("EventTarget")}}, на все перечисленные события можно подписаться, используя метод {{domxref("EventTarget.addEventListener()","addEventListener")}}.
> [!NOTE]
> Т.к. `FileReader` унаследован от {{domxref("EventTarget")}}, на все перечисленные события можно подписаться, используя метод {{domxref("EventTarget.addEventListener()","addEventListener")}}.

### Константы состояния

Expand Down
3 changes: 2 additions & 1 deletion files/ru/web/api/filereader/readasdataurl/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,8 @@ l10n:

Метод `readAsDataURL()` интерфейса {{domxref("FileReader")}} используется для чтения содержимого {{domxref("Blob")}} или {{domxref("File")}}. После завершения операции свойство {{domxref("FileReader.readyState", "readyState")}} принимает значение `DONE` и возникает событие {{domxref("FileReader/loadend_event", "loadend")}}. В то же время атрибут {{domxref("FileReader.result", "result")}} будет содержать данные файла, закодированные в `base64`-строку в виде [Data URL](/ru/docs/Web/HTTP/Basics_of_HTTP/Data_URLs).

> **Note:** Атрибут {{domxref("FileReader.result","result")}} не может быть напрямую декодирован как Base64 без предварительного удаления объявления `Data URL`, которое предшествует данным в кодировке `base64`. Чтобы получить только строку в кодировке `base64`, необходимо удалить `data:*/*;base64,` из результата.
> [!NOTE]
> Атрибут {{domxref("FileReader.result","result")}} не может быть напрямую декодирован как Base64 без предварительного удаления объявления `Data URL`, которое предшествует данным в кодировке `base64`. Чтобы получить только строку в кодировке `base64`, необходимо удалить `data:*/*;base64,` из результата.

## Синтаксис

Expand Down
5 changes: 2 additions & 3 deletions files/ru/web/api/formdata/append/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,8 +11,6 @@ slug: Web/API/FormData/append

Разница между {{domxref("FormData.set")}} и `append()` в том, что если заданный ключ уже существует, {{domxref("FormData.set")}} заменит данные в нем на новые, а `append()` добавит новое значение к остальным в конец.

> **Примечание:** Данный метод также доступен в [Web Workers](/ru/docs/Web/API/Web_Workers_API).

## Синтаксис

Существует две формы использования данной функции: с двумя и тремя параметрами:
Expand All @@ -31,7 +29,8 @@ formData.append(name, value, filename);
- `filename` {{optional_inline}}
- : Имя файла которое будет отправлено серверу ({{domxref("USVString")}}), когда {{domxref("Blob")}} или {{domxref("File")}} прошёл проверку как второй параметр. Стандартное имя файла для {{domxref("Blob")}} объектов это "blob".

> **Примечание:** Если вы укажете {{domxref("Blob")}} в качестве данных для включения в объект `FormData`, имя файла будет указано для сервера в заголовке "Content-Disposition" и может отличаться от браузера к браузеру.
> [!NOTE]
> Если вы укажете {{domxref("Blob")}} в качестве данных для включения в объект `FormData`, имя файла будет указано для сервера в заголовке "Content-Disposition" и может отличаться от браузера к браузеру.

### Возвращает

Expand Down
2 changes: 0 additions & 2 deletions files/ru/web/api/formdata/delete/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,6 @@ slug: Web/API/FormData/delete

Метод **`delete()`** интерфейса {{domxref("FormData")}} удаляет ключ и его значение(-ия) из объекта `FormData`.

> **Примечание:** Этот метод доступен в [Web Workers](/ru/docs/Web/API/Web_Workers_API).

## Синтаксис

```js
Expand Down
2 changes: 0 additions & 2 deletions files/ru/web/api/formdata/entries/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,6 @@ slug: Web/API/FormData/entries

Метод **`FormData.entries()`** возвращает {{jsxref("Iteration_protocols",'iterator')}}, позволяя пройтись по всем ключам/значениям в этом объекте. Ключ каждой пары - это объект {{domxref("USVString")}}, значение - это {{domxref("USVString")}} или {{domxref("Blob")}}.

> **Примечание:** Метод доступен в [Web Workers](/ru/docs/Web/API/Web_Workers_API).

## Синтаксис

```
Expand Down
3 changes: 2 additions & 1 deletion files/ru/web/api/formdata/formdata/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,8 @@ console.log(formData.get("code"), formData === oldForm);

### Методы

> **Примечание:** Подробнее о каждом методе можно прочитать, выбрав его в колонке слева.
> [!NOTE]
> Подробнее о каждом методе можно прочитать, выбрав его в колонке слева.

Добавление нового текстового поля в форму:

Expand Down
2 changes: 0 additions & 2 deletions files/ru/web/api/formdata/get/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,6 @@ slug: Web/API/FormData/get

Метод get() из интерфейса {{domxref("FormData")}} возвращает первое значение, связанное с переданным ключом из объекта FormData. Если вы ожидаете множественные значения и хотите получить их все, используйте метод getAll().

> **Примечание:** Примечание: Этот метод доступен в [Web Workers](/ru/docs/Web/API/Web_Workers_API).

## Синтаксис

```
Expand Down
2 changes: 0 additions & 2 deletions files/ru/web/api/formdata/getall/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,6 @@ slug: Web/API/FormData/getAll

**`getAll()`** - метод объекта {{domxref("FormData")}}, который возвращает все значения, связанные с ключом в объекте FormData.

> **Примечание:** Этот метод доступен в [Web Workers](/ru/docs/Web/API/Web_Workers_API).

## Синтаксис

```js
Expand Down
2 changes: 0 additions & 2 deletions files/ru/web/api/formdata/has/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,6 @@ slug: Web/API/FormData/has

Метод **`has()`** из интерфейса {{domxref("FormData")}} возвращает логическое значение, указывающее, содержит ли объект `FormData` указанный ключ.

> **Примечание:** Примечание: Этот метод доступен в [Web Workers](/ru/docs/Web/API/Web_Workers_API).

## Синтаксис

```js
Expand Down
Loading