universal-links-test

Check apple-app-site-association file to verify universal links.

Installation

npm install -D universal-links-test
Copy

Usage

The verify function detects provided path lauches the app or not.

It depends on the swcutil command (preinstalled in macOS), so you must use this function in macOS and root permission. If you don't use macOS, you can use universal-links-test/sim instead that simulates the behavior.

import { verify, type AppleAppSiteAssociation } from "universal-links-test";
// import { verify, type AppleAppSiteAssociation } from "universal-links-test/sim";

const json = {
  applinks: {
    details: [
      {
        appID: "APP.ID1",
        components: [{ "/": "/universal-links/path" }]
      },
      {
        appID: "APP.ID2",
        components: [{ "/": "/universal-links/path", exclude: true }]
      },
      {
        appID: "APP.ID3",
        components: []
      }
    ]
  }
} satisfies AppleAppSiteAssociation;

const result: Map<string, 'match' | 'block'> = await verify(json, "/universal-links/path?query#hash");
console.log(result.get("APP.ID1")); // 'match' : Universal links are working
console.log(result.get("APP.ID2")); // 'block' : Universal links are blocked
console.log(result.get("APP.ID3")); // undefined
Copy

Use swcutil command programmatically:

import { swcutil } from 'universal-links-test/swcutil';
const { status, stdout, stderr } = await swcutil({
  // ...
});
Copy

LICENSE

MIT