Network Information API

Переклад цієї статті ще не завершено. Будь ласка, допоможіть перекласти цю статтю з англійської мови

This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

Network Information API надає інформацію про мережеве підключення в загальних термінах ('wifi', 'cellular' тощо). Ця інформація може бути використана для вибору якості і розміру вмісту на основі підключення користувача. Весь API складається з інтерфейсу NetworkInformation та однієї властивості до інтерфейсу Navigator: Navigator.connection .

Note: This feature is available in Web Workers.

Приклади

Виявлення зміни підключення

В цьому прикладі ми стежимо за змінами підключення користувача.

var connection = navigator.connection || navigator.mozConnection || navigator.webkitConnection;
var type = connection.effectiveType;

function updateConnectionStatus() {
  console.log("Тип підключення було змінено з " + type + " на " + connection.effectiveType);
  type = connection.effectiveType;
}

connection.addEventListener('change', updateConnectionStatus);

Попереднє завантаження великих ресурсів

Об'єкт підключення Navigator.connection корисний для визначення необхідності попереднього завантажування ресурсів, що мають великий розмір. Перевірка типу підключення буде викликана незабаром після завантаження сторінки. Якщо з'єднання визначено як стільниковий зв’язок, то прапорець preloadVideo буде встановлено у значення false. Для простоти та наочності цей приклад перевіряє лише один тип підключення. На практиці використовується оператор switch або інший метод для перевірки всіх можливих значень NetworkInformation.type. Незалежно від значення type ви можете оцінити швидкість з'єднання через властивість NetworkInformation.effectiveType.

let preloadVideo = true;
var connection = navigator.connection || navigator.mozConnection || navigator.webkitConnection;
if (connection) {
  if (connection.effectiveType === 'slow-2g') {
    preloadVideo = false;
  }
}

Інтерфейси

NetworkInformation
Надає інформацію про з’єднання, яке пристрій використовує для зв’язку з мережею, та забезпечує сповіщення, якщо тип з’єднання змінюється. Інтерфейс NetworkInformation  не може бути створено як екземпляр. Натомість доступ до нього здійснюється через інтерфейс Navigator.

Специфікації

Специфікація Статус Коментар
Network Information API
The definition of 'Network Information API' in that specification.
Draft Initial specification

Сумісність

NetworkInformation

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
NetworkInformation
Experimental
Chrome Full support 61Edge Full support 79Firefox No support NoIE No support NoOpera Full support 48Safari No support NoWebView Android Full support 50Chrome Android Full support 38Firefox Android Full support 31Opera Android Full support 45Safari iOS No support NoSamsung Internet Android Full support 3.0
downlink
Experimental
Chrome Full support 61Edge Full support 79Firefox No support NoIE No support NoOpera Full support 48Safari No support NoWebView Android Full support 50Chrome Android Full support 38Firefox Android ? Opera Android Full support 45Safari iOS No support NoSamsung Internet Android Full support 3.0
downlinkMax
Experimental
Chrome Full support 61
Notes
Full support 61
Notes
Notes Only supported in Chrome OS
Edge No support NoFirefox No support NoIE No support NoOpera No support NoSafari No support NoWebView Android Full support 50Chrome Android Full support 38Firefox Android No support NoOpera Android Full support 45Safari iOS No support NoSamsung Internet Android Full support 3.0
effectiveType
Experimental
Chrome Full support 61Edge Full support 79Firefox No support NoIE No support NoOpera Full support 48Safari No support NoWebView Android Full support 50Chrome Android Full support 38Firefox Android Full support YesOpera Android Full support 45Safari iOS No support NoSamsung Internet Android Full support 3.0
onchange
Experimental
Chrome Full support 61Edge Full support 79Firefox No support NoIE No support NoOpera Full support 48Safari No support NoWebView Android Full support 50Chrome Android Full support 38Firefox Android No support No
Notes
No support No
Notes
Notes On Firefox, the event handler property corresponding to the change event is ontypechange.
Opera Android Full support 45Safari iOS No support NoSamsung Internet Android Full support 3.0
ontypechange
Experimental
Chrome No support NoEdge No support NoFirefox No support NoIE No support NoOpera ? Safari No support NoWebView Android No support NoChrome Android No support NoFirefox Android ? Opera Android ? Safari iOS No support NoSamsung Internet Android No support No
rtt
Experimental
Chrome Full support 61Edge Full support 79Firefox No support NoIE No support NoOpera Full support 48Safari No support NoWebView Android Full support 50Chrome Android Full support 38Firefox Android No support NoOpera Android Full support 45Safari iOS No support NoSamsung Internet Android Full support 3.0
saveData
Experimental
Chrome Full support 65Edge Full support 79Firefox No support NoIE No support NoOpera Full support YesSafari No support NoWebView Android Full support 65Chrome Android Full support 65Firefox Android ? Opera Android Full support YesSafari iOS No support NoSamsung Internet Android Full support 9.0
type
Experimental
Chrome Full support 61
Notes
Full support 61
Notes
Notes Only supported in Chrome OS
Edge No support NoFirefox No support NoIE No support NoOpera No support NoSafari No support NoWebView Android Full support 50Chrome Android Full support 38Firefox Android No support NoOpera Android Full support 45Safari iOS No support NoSamsung Internet Android Full support 3.0
Available in workers
Experimental
Chrome Full support 61Edge Full support 79Firefox No support NoIE No support NoOpera Full support 48Safari No support NoWebView Android Full support 50Chrome Android Full support 38Firefox Android Full support 53Opera Android Full support 45Safari iOS No support NoSamsung Internet Android Full support 3.0

Legend

Full support  
Full support
No support  
No support
Compatibility unknown  
Compatibility unknown
Experimental. Expect behavior to change in the future.
Experimental. Expect behavior to change in the future.
See implementation notes.
See implementation notes.
Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
connection
Experimental
Chrome Full support 61Edge Full support 79Firefox Full support Yes
Disabled
Full support Yes
Disabled
Disabled This feature is behind the dom.netinfo.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE No support NoOpera Full support YesSafari No support NoWebView Android Full support 50Chrome Android Full support 38Firefox Android Full support 14
Notes
Full support 14
Notes
Notes The Network API is enabled by default. Can be disabled using the dom.netinfo.enabled preference.
Opera Android Full support 37Safari iOS No support NoSamsung Internet Android Full support 3.0

Legend

Full support  
Full support
No support  
No support
Experimental. Expect behavior to change in the future.
Experimental. Expect behavior to change in the future.
See implementation notes.
See implementation notes.
User must explicitly enable this feature.
User must explicitly enable this feature.

Дивіться також