Navigator: canShare() メソッド
利用可能性は限定的
この機能はベースラインではありません。最も広く使用されているブラウザーの一部で動作しません。
Want more browser support for this feature? Tell us why.
安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。
canShare() は Navigator インターフェイスのメソッドで、同等の navigator.share() の呼び出しが成功するようであれば true を返します。
データが検証できない場合は、このメソッドは false を返します。データが無効になる理由としては、次のものがあります。
data引数が除外されているか、不明な値を持つプロパティしかない場合。ユーザーエージェントが認識できないプロパティは無視されることに注意してください。- URL の形式が正しくない場合。
- ファイルが指定されているが、実装がファイル共有に対応していない場合。
- 指定したデータを共有すると、ユーザーエージェントから「敵対的な共有」と見なされる場合。
ウェブ共有 APIは web-share 権限ポリシーによって制限されています。
canShare() メソッドは、その権限に対応しているが付与されていない場合、 false を返します。
構文
canShare()
canShare(data)
引数
data省略可-
テストする共有データを定義したオブジェクトです。 通常、この呼び出しが
trueを返す場合、同じプロパティを持つオブジェクトがnavigator.share()に渡されます。ユーザーエージェントが認識していないプロパティは無視されます。共有データは、ユーザーエージェントが理解しているプロパティに対してのみ評価されます。 プロパティはすべて任意ですが、少なくともひとつの既知のデータプロパティを指定しなければ、このメソッドは
falseを返します。使用可能な値は以下の通りです。
返値
指定した data が Navigator.share() で共有できる場合は true を、そうでない場合は false を返します。
例
MDN URL の送信
この例では navigator.canShare() を使用して、指定されたデータが navigator.share() で共有できるかどうかを調べています。
HTML
HTML は、テストの結果を表示するための段落を作成するだけです。
<p class="result"></p>
JavaScript
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() に対応していません。";
} else if (navigator.canShare(shareData)) {
resultPara.textContent =
"navigator.canShare() に対応しています。navigator.share() を使ってデータを送ることができます。";
} else {
resultPara.textContent = "指定されたデータは共有できません。";
}
結果
以下のボックスには、 navigator.canShare() がこのブラウザーで対応しているかどうか、対応している場合は navigator.share() を使用して指定したデータを共有できるかどうかが記載されているはずです。
機能の調査例
このメソッドの機能は、特定のデータプロパティが有効で共有可能であるかどうかをテストします。
単一の data プロパティで使用した場合、そのプロパティが有効で、プラットフォーム上で共有できる場合にのみ true を返します。
下記のコードは、あるデータプロパティが対応しているかどうかを確認する例です。
// 対応していない可能性のある機能
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 {
// 新しいデータプロパティが共有できない場合の処理
}
仕様書
| 仕様書 |
|---|
| Web Share API # canshare-data-method |