Navigator.canShare()

安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。

Navigator.canShare() はウェブ共有 API のメソッドで、同等の navigator.share() の呼び出しが成功するようであれば true を返します。

データが検証できない場合は、このメソッドは false を返します。データが無効になる理由としては、次のものがあります。

  • data 引数が除外されているか、不明な値を持つプロパティしかない場合。ユーザーエージェントが認識できないプロパティは無視されることに注意してください。
  • URL の形式が正しくない場合。
  • ファイルが指定されているが、実装がファイル共有に対応していない場合。
  • 指定したデータを共有すると、ユーザーエージェントから「敵対的な共有」と見なされる場合。

ウェブ共有 API は web-share 権限ポリシーによって制限されています。 canShare() メソッドは、その権限に対応しているが付与されていない場合、 false を返します。

構文

js
canShare()
canShare(data)

引数

data 省略可

テストする共有データを定義したオブジェクトです。 通常、この呼び出しが true を返す場合、同じプロパティを持つオブジェクトが navigator.share() に渡されます。

ユーザーエージェントが認識していないプロパティは無視されます。共有データは、ユーザーエージェントが理解しているプロパティに対してのみ評価されます。 プロパティはすべて任意ですが、少なくともひとつの既知のデータプロパティを指定しなければ、このメソッドは false を返します。

使用可能な値は以下の通りです。

  • url: 共有される URL を表す文字列。
  • text: 共有されるテキストを表す文字列。
  • title: 共有されるタイトルを表す文字列。
  • files: 共有されるファイルを表す File オブジェクトの配列。

返値

指定した data が Navigator.share() で共有できる場合は true を、そうでない場合は false を返します。

例

MDN URL の送信

この例では navigator.canShare() を使用して、指定されたデータが navigator.share() で共有できるかどうかを調べています。

HTML

HTML は、テストの結果を表示するための段落を作成するだけです。

html
<p class="result"></p>

JavaScript

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

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

if (!navigator.canShare) {
  resultPara.textContent = "navigator.canShare() not supported.";
} else if (navigator.canShare(shareData)) {
  resultPara.textContent =
    "navigator.canShare() supported. We can use navigator.share() to send the data.";
} else {
  resultPara.textContent = "Specified data cannot be shared.";
}

結果

下記のボックスには、 navigator.canShare() がこのブラウザーで対応しているかどうか、対応している場合は navigator.share() を使用して指定したデータを共有できるかどうかが記載されているはずです。

機能の調査例

このメソッドの機能は、特定のデータプロパティが有効で共有可能であるかどうかをテストします。 単一の data プロパティで使用した場合、そのプロパティが有効で、プラットフォーム上で共有できる場合にのみ true を返します。

下記のコードは、あるデータプロパティが対応しているかどうかを確認する例です。

js
// 対応していない可能性のある機能
let testShare = { someNewProperty: "Data to share" };

// 新しいキーを使用する複合データ
const shareData = {
  title: "MDN",
  text: "Learn web development on MDN!",
  url: "https://developer.mozilla.org",
  someNewProperty: "Data to share",
};

// 共有する前に、キーが有効で対応していることをテストします。
if (navigator.canShare(testShare)) {
  // navigator.share() を使用して 'shareData' を使用する
} else {
  // 新しいデータプロパティが共有できない場合の処理
}

仕様書

Specification
Web Share API
# canshare-data-method

ブラウザーの互換性

BCD tables only load in the browser

関連情報