API для совместного использования веб-страниц

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

API для совместного использования веб-страниц позволяет сайту обмениваться текстом, ссылками, файлами и другим содержимым с выбранными пользователем целевыми объектами совместного использования, используя механизмы совместного использования в операционной системе. Эти целевые объекты, как правило, включают буфер обмена системы, электронную почту, приложения для контактов или обмена сообщениями, а также каналы Bluetooth или Wi-Fi.

API имеет всего два метода. Метод navigator.canShare() может быть использован для предварительной проверки того, является ли некоторый набор данных «разделяемым», прежде чем передать его методу navigator.share() для отправки.

Метод navigator.share() вызывает механизм совместного использования операционной системы и передает указанные данные. Он требует временного активирования, поэтому его следует запускать от события пользовательского интерфейса, например, нажатия на кнопку. Кроме того, метод должен указывать данные, поддерживаемые для совместного использования в реализации нативного API.

API для совместного использования веб-страниц регулируется политикой разрешений web-share. Если политика поддерживается, но не предоставлена, оба метода укажут, что данные не являются разделяемыми.

navigator.canShare()

Возвращает булево значение, указывающее, являются ли указанные данные разделяемыми.

navigator.share()

Возвращает Promise, который разрешается, если переданные данные успешно отправлены в целевой объект совместного использования. Этот метод должен вызываться при нажатии на кнопку или другом пользовательском действии (требуется временное активирование).

Код ниже демонстрирует, как можно поделиться ссылкой, используя navigator.share(), вызываемое при нажатии на кнопку.

const shareData = {
  title: "MDN",
  text: "Learn web development on MDN!",
  url: "https://developer.mozilla.org",
};

const btn = document.querySelector("button");
const resultPara = document.querySelector(".result");

// Share must be triggered by "user activation"
btn.addEventListener("click", async () => {
  try {
    await navigator.share(shareData);
    resultPara.textContent = "MDN shared successfully";
  } catch (err) {
    resultPara.textContent = `Error: ${err}`;
  }
});

Данный пример взят из нашего теста совместного использования веб-страниц (посмотреть исходный код). Вы также можете увидеть этот пример в действии по адресу navigator.share().

• API для целевых веб-обменов