diff options
Diffstat (limited to 'files/ru/web/api/abortsignal')
-rw-r--r-- | files/ru/web/api/abortsignal/abort_event/index.html | 134 | ||||
-rw-r--r-- | files/ru/web/api/abortsignal/aborted/index.html | 60 | ||||
-rw-r--r-- | files/ru/web/api/abortsignal/index.html | 98 | ||||
-rw-r--r-- | files/ru/web/api/abortsignal/onabort/index.html | 53 |
4 files changed, 345 insertions, 0 deletions
diff --git a/files/ru/web/api/abortsignal/abort_event/index.html b/files/ru/web/api/abortsignal/abort_event/index.html new file mode 100644 index 0000000000..15a89fd35e --- /dev/null +++ b/files/ru/web/api/abortsignal/abort_event/index.html @@ -0,0 +1,134 @@ +--- +title: abort +slug: Web/API/AbortSignal/abort_event +translation_of: Web/API/AbortSignal/abort_event +--- +<div>{{SeeCompatTable}}</div> + +<p>Событие <code><strong>abort</strong></code> из <a href="/en-US/docs/Web/API/Fetch_API">Fetch API</a> вызывается когда fetch запрос прерывается, т.е. с помощью {{domxref("AbortController.abort()")}}.</p> + +<table class="properties"> + <tbody> + <tr> + <td>Bubbles</td> + <td>Нет</td> + </tr> + <tr> + <td>Cancelable</td> + <td>Нет</td> + </tr> + <tr> + <td>Target objects</td> + <td>{{domxref("AbortSignal")}}</td> + </tr> + <tr> + <td>Interface</td> + <td>{{domxref("Event")}}</td> + </tr> + </tbody> +</table> + +<h2 id="Примеры">Примеры</h2> + +<p> </p> + +<p>В следующем фрагменте мы создаём новый объект {{domxref("AbortController")}}, и получаем его {{domxref("AbortSignal")}} (доступно в свойстве <code>signal</code>). Позже мы проверяем, был ли прерван сигнал, используя свойство <code>aborted</code>, и выводим соответствующее сообщение в консоль.</p> + +<p> </p> + +<pre class="brush: js">var controller = new AbortController(); +var signal = controller.signal; + +signal.onabort = function() { + console.log('Request aborted'); +}; +</pre> + +<h2 id="Наследование">Наследование</h2> + +<p>Событие <code>abort</code> реализует {{domxref("Event")}} интерфейс — он имеет свойства и методы, определённые в нём.</p> + +<h2 id="Спецификации">Спецификации</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Спецификация</th> + <th scope="col">Статус</th> + <th scope="col">Комментарий</th> + </tr> + <tr> + <td>{{SpecName('DOM WHATWG', '#dom-abortsignal-onabort', 'abort')}}</td> + <td>{{Spec2('DOM WHATWG')}}</td> + <td>Initial definition</td> + </tr> + </tbody> +</table> + +<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2> + +<p>{{CompatibilityTable}}</p> + +<div id="compat-desktop"> +<table class="compat-table"> + <tbody> + <tr> + <th>Feature</th> + <th>Chrome</th> + <th>Edge</th> + <th>Firefox (Gecko)</th> + <th>Internet Explorer</th> + <th>Opera</th> + <th>Safari (WebKit)</th> + </tr> + <tr> + <td>Basic support</td> + <td> + <p>{{CompatUnknown}}</p> + </td> + <td>{{CompatUnknown}}</td> + <td>{{CompatGeckoDesktop(57)}}</td> + <td>{{CompatNo}}</td> + <td> + <p>{{CompatUnknown}}</p> + </td> + <td>{{CompatNo}}</td> + </tr> + </tbody> +</table> +</div> + +<div id="compat-mobile"> +<table class="compat-table"> + <tbody> + <tr> + <th>Feature</th> + <th>Android</th> + <th>Android Webview</th> + <th>Edge</th> + <th>Firefox Mobile (Gecko)</th> + <th>IE Phone</th> + <th>Opera Mobile</th> + <th>Safari Mobile</th> + <th>Chrome for Android</th> + </tr> + <tr> + <td>Basic support</td> + <td>{{CompatNo}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatGeckoMobile(57)}}</td> + <td>{{CompatNo}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatNo}}</td> + <td>{{CompatUnknown}}</td> + </tr> + </tbody> +</table> +</div> + +<h2 id="Смотрите_также">Смотрите также</h2> + +<ul> + <li><a href="/en-US/docs/Web/API/Fetch_API">Fetch API</a></li> +</ul> diff --git a/files/ru/web/api/abortsignal/aborted/index.html b/files/ru/web/api/abortsignal/aborted/index.html new file mode 100644 index 0000000000..1841427cd2 --- /dev/null +++ b/files/ru/web/api/abortsignal/aborted/index.html @@ -0,0 +1,60 @@ +--- +title: AbortSignal.aborted +slug: Web/API/AbortSignal/aborted +tags: + - Свойство + - Экспериментально +translation_of: Web/API/AbortSignal/aborted +--- +<div>{{APIRef("DOM")}}{{SeeCompatTable}}</div> + +<p>Свойство <strong><code>aborted</code></strong> только для чтения, оно возвращает {{domxref("Boolean")}}, который указывает прерван(<code>true</code>) DOM зыпрос(ы), с которым связан сигнал, или нет(<code>false</code>).</p> + +<h2 id="Синтаксис">Синтаксис</h2> + +<pre class="brush: js">var isAborted = abortSignal.aborted;</pre> + +<h3 id="Значение">Значение</h3> + +<p>{{domxref("Boolean")}}</p> + +<h2 id="Примеры">Примеры</h2> + +<p>В следующем фрагменте мы создаём новый объект {{domxref("AbortController")}}, и получаем его {{domxref("AbortSignal")}} (доступно в свойстве <code>signal</code>). Позже мы проверяем, был ли прерван сигнал, используя свойство <code>aborted</code>, и выводим соответствующее сообщение в консоль.</p> + +<pre class="brush: js">var controller = new AbortController(); +var signal = controller.signal; + +// ... + +signal.aborted ? console.log('Запрос был отменён') : console.log('Запрос не отменён'); +</pre> + +<h2 id="Спецификации">Спецификации</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Спецификация</th> + <th scope="col">Статус</th> + <th scope="col">Комментарий</th> + </tr> + <tr> + <td>{{SpecName('DOM WHATWG', '#dom-abortsignal-onabort', 'onabort')}}</td> + <td>{{Spec2('DOM WHATWG')}}</td> + <td>Initial definition</td> + </tr> + </tbody> +</table> + +<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2> + + + +<p>{{Compat("api.AbortSignal.aborted")}}</p> + +<h2 id="Смотрите_также">Смотрите также</h2> + +<ul> + <li><a href="/en-US/docs/Web/API/Fetch_API">Fetch API</a></li> +</ul> diff --git a/files/ru/web/api/abortsignal/index.html b/files/ru/web/api/abortsignal/index.html new file mode 100644 index 0000000000..fb44706bc7 --- /dev/null +++ b/files/ru/web/api/abortsignal/index.html @@ -0,0 +1,98 @@ +--- +title: AbortSignal +slug: Web/API/AbortSignal +translation_of: Web/API/AbortSignal +--- +<div>{{APIRef("DOM")}}{{SeeCompatTable}}</div> + +<p><strong><code>AbortSignal</code></strong> интерфейс представляет собой объект сигнала, который позволяет вам общаться с DOM запросом (например, Fetch) и прервать его при необходимости с помощью объекта {{domxref("AbortController")}}.</p> + +<h2 id="Свойства">Свойства</h2> + +<p><em>AbortSignal также наследует свойства от своего родительского интерфейса, {{domxref("EventTarget")}}.</em></p> + +<dl> + <dt>{{domxref("AbortSignal.aborted")}} {{readonlyInline}}</dt> + <dd>Это {{domxref("Boolean")}}, который указывает, отменен ли запрос(ы), с которым связывался сигнал, отменён (<code>true</code>) или нет (<code>false</code>).</dd> +</dl> + +<h3 id="Обработчики_событий">Обработчики событий</h3> + +<dl> + <dt>{{domxref("AbortSignal.onabort")}}</dt> + <dd>Вызывается когда происходит событие {{event("abort_(dom_abort_api)", "abort")}}, т.е. когда DOM запрос(ы), с которым связывался сигнал, отменён.</dd> +</dl> + +<h2 id="Методы">Методы</h2> + +<p><em>AbortSignal наследует методы от родительского интерфейса, {{domxref("EventTarget")}}.</em></p> + +<h2 id="Примеры">Примеры</h2> + +<p>В следующем фрагменте мы будем загружать видео используя <a href="/en-US/docs/Web/API/Fetch_API">Fetch API</a>.</p> + +<p>Сначала мы создаём контроллер с помощью контруктора {{domxref("AbortController.AbortController","AbortController()")}}, а затем получаем ссылку на связанный объект {{domxref("AbortSignal")}} используя свойство {{domxref("AbortController.signal")}}.</p> + +<p>Когда <a href="/en-US/docs/Web/API/WindowOrWorkerGlobalScope/fetch">fetch запрос</a> инициируется, мы передаём <code>AbortSignal</code> в качестве опции внутрь объекта параметров запроса (см. <code>{signal}</code> ниже). Это связывает сигнал и контроллер с fetch запросом и позволяет нам прервать его, вызвав {{domxref("AbortController.abort()")}}, как показано ниже во втором прослушивателе событий.</p> + +<pre class="brush: js">var controller = new AbortController(); +var signal = controller.signal; + +var downloadBtn = document.querySelector('.download'); +var abortBtn = document.querySelector('.abort'); + +downloadBtn.addEventListener('click', fetchVideo); + +abortBtn.addEventListener('click', function() { + controller.abort(); + console.log('Загрузка прервана'); +}); + +function fetchVideo() { + ... + fetch(url, {signal}).then(function(response) { + ... + }).catch(function(e) { + reports.textContent = 'Ошибка загрузки: ' + e.message; + }) +}</pre> + +<div class="note"> +<p><strong>Примечание</strong>: Когда <code>abort()</code> вызывается, <code>fetch()</code> обещаение отклоняется с <code>AbortError</code>.</p> +</div> + +<div class="warning"> +<p>Текущая версия Firefox отклоняет обещание с <code>DOMException</code></p> +</div> + +<p>Вы можете найти полный рабочий пример на GitHub — см. <a href="https://github.com/mdn/dom-examples/tree/master/abort-api">abort-api</a> (<a href="https://mdn.github.io/dom-examples/abort-api/">см. как он работает в живую</a>).</p> + +<h2 id="Спецификации">Спецификации</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Спецификация</th> + <th scope="col">Статус</th> + <th scope="col">Комментарий</th> + </tr> + <tr> + <td>{{SpecName('DOM WHATWG', '#interface-AbortSignal', 'AbortSignal')}}</td> + <td>{{Spec2('DOM WHATWG')}}</td> + <td>Initial definition</td> + </tr> + </tbody> +</table> + +<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2> + + + +<p>{{Compat("api.AbortSignal")}}</p> + +<h2 id="Смотрите_также">Смотрите также</h2> + +<ul> + <li><a href="/en-US/docs/Web/API/Fetch_API">Fetch API</a></li> + <li><a href="https://developers.google.com/web/updates/2017/09/abortable-fetch">Abortable Fetch</a> by Jake Archibald</li> +</ul> diff --git a/files/ru/web/api/abortsignal/onabort/index.html b/files/ru/web/api/abortsignal/onabort/index.html new file mode 100644 index 0000000000..068d91813d --- /dev/null +++ b/files/ru/web/api/abortsignal/onabort/index.html @@ -0,0 +1,53 @@ +--- +title: AbortSignal.onabort +slug: Web/API/AbortSignal/onabort +translation_of: Web/API/AbortSignal/onabort +--- +<div>{{APIRef("DOM")}}{{SeeCompatTable}}</div> + +<p>Cвойство <strong><code>onabort</code></strong> интерфейса {{domxref("AbortSignal")}} является обработчиком события {{event("abort_(cancellable_fetch)", "abort")}} и вызывается при его срабатывании, т.е. когда fetch запрос(ы), с которым связан сигнал, был отменён.</p> + +<h2 id="Синтаксис">Синтаксис</h2> + +<pre class="brush: js">abortSignal.onabort = function() { ... };</pre> + +<h2 id="Примеры">Примеры</h2> + +<p>В следующем фрагменте мы создаём новый объект {{domxref("AbortController")}}, и получаем его {{domxref("AbortSignal")}} (доступно в свойстве <code>signal</code>). Позже с помощью свойства <font face="consolas, Liberation Mono, courier, monospace"><span style="background-color: rgba(220, 220, 220, 0.5);">onabort</span></font> мы проверяем, был ли прерван сигнал, и выводим соответствующее сообщение в консоль.</p> + +<pre class="brush: js">var controller = new AbortController(); +var signal = controller.signal; + +signal.onabort = function() { + console.log('Запрос прерван'); +}; +</pre> + +<h2 id="Спецификации">Спецификации</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Спецификация</th> + <th scope="col">Статус</th> + <th scope="col">Комментарий</th> + </tr> + <tr> + <td>{{SpecName('DOM WHATWG', '#dom-abortsignal-aborted', 'onabort')}}</td> + <td>{{Spec2('DOM WHATWG')}}</td> + <td>Initial definition</td> + </tr> + </tbody> +</table> + +<h2 id="Совместимость_с_брузерами">Совместимость с брузерами</h2> + + + +<p>{{Compat("api.AbortSignal.onabort")}}</p> + +<h2 id="Смотрите_также">Смотрите также</h2> + +<ul> + <li><a href="/en-US/docs/Web/API/Fetch_API">Fetch API</a></li> +</ul> |