JavaScript Navigator getInstalledRelatedApps() Method

const lines = [
  "getInstalledRelatedApps: " +
    (typeof navigator.getInstalledRelatedApps === "function"
      ? "available"
      : "missing"),
  "isSecureContext: " + window.isSecureContext,
  "topLevel: " + (window.top === window.self)
];
console.log(lines.join("\n"));

async function queryRelatedApps() {
  if (!navigator.getInstalledRelatedApps) {
    return "API not supported";
  }
  try {
    const relatedApps = await navigator.getInstalledRelatedApps();
    console.table(relatedApps);
    return "related apps found: " + relatedApps.length;
  } catch (err) {
    return "Error: " + err.name;
  }
}

queryRelatedApps().then(console.log);

async function findRelatedApp(appId) {
  if (!navigator.getInstalledRelatedApps) {
    return "API not supported";
  }
  const relatedApps = await navigator.getInstalledRelatedApps();
  const psApp = relatedApps.find((app) => app.id === appId);
  if (!psApp) return "Related app not installed (or not associated)";
  return (
    "Found platform=" + psApp.platform +
    " version=" + (psApp.version || "n/a")
  );
}

findRelatedApp("com.example.myapp").then(console.log);

async function shouldShowInstallBanner() {
  if (!navigator.getInstalledRelatedApps) {
    return { show: true, reason: "api-missing" };
  }
  try {
    const relatedApps = await navigator.getInstalledRelatedApps();
    if (relatedApps.length > 0) {
      return { show: false, reason: "related-app-installed", count: relatedApps.length };
    }
    return { show: true, reason: "none-installed" };
  } catch (err) {
    return { show: true, reason: err.name };
  }
}

shouldShowInstallBanner().then((result) => {
  console.log(JSON.stringify(result));
});

async function getRelatedAppsSafe() {
  if (typeof navigator.getInstalledRelatedApps !== "function") {
    return { ok: false, apps: [], reason: "unsupported" };
  }
  if (!window.isSecureContext) {
    return { ok: false, apps: [], reason: "insecure-context" };
  }
  if (window.top !== window.self) {
    return { ok: false, apps: [], reason: "not-top-level" };
  }
  try {
    const apps = await navigator.getInstalledRelatedApps();
    return { ok: true, apps: apps, reason: "ok" };
  } catch (err) {
    return { ok: false, apps: [], reason: err.name };
  }
}

getRelatedAppsSafe().then((result) => {
  console.log(JSON.stringify({
    ok: result.ok,
    reason: result.reason,
    count: result.apps.length
  }));
});