diff options
author | Trivikram Kamat <16024985+trivikr@users.noreply.github.com> | 2020-09-27 19:47:00 -0700 |
---|---|---|
committer | GitHub <noreply@github.com> | 2020-09-28 12:47:00 +1000 |
commit | 1437838ea19bf2e33f28ed4d30b1aa7c5aa5286e (patch) | |
tree | e5f7aa91b96457b307d57a9a9a1ecf7b9217ce65 /docs/runtime | |
parent | 54d897c140c5c5f294f69c8e6b87f7d169c21066 (diff) |
docs: use const assertion for PermissionDescriptor (#7733)
Fixes #7731
Diffstat (limited to 'docs/runtime')
-rw-r--r-- | docs/runtime/permission_apis.md | 38 |
1 files changed, 19 insertions, 19 deletions
diff --git a/docs/runtime/permission_apis.md b/docs/runtime/permission_apis.md index a76f0c0d4..14314035d 100644 --- a/docs/runtime/permission_apis.md +++ b/docs/runtime/permission_apis.md @@ -16,26 +16,26 @@ On the CLI, read permission for `/foo/bar` is represented as `--allow-read=/foo/bar`. In runtime JS, it is represented as the following: ```ts -const desc = { name: "read", path: "/foo/bar" }; +const desc = { name: "read", path: "/foo/bar" } as const; ``` Other examples: ```ts // Global write permission. -const desc1 = { name: "write" }; +const desc1 = { name: "write" } as const; // Write permission to `$PWD/foo/bar`. -const desc2 = { name: "write", path: "foo/bar" }; +const desc2 = { name: "write", path: "foo/bar" } as const; // Global net permission. -const desc3 = { name: "net" }; +const desc3 = { name: "net" } as const; // Net permission to 127.0.0.1:8000. -const desc4 = { name: "net", url: "127.0.0.1:8000" }; +const desc4 = { name: "net", url: "127.0.0.1:8000" } as const; // High-resolution time permission. -const desc5 = { name: "hrtime" }; +const desc5 = { name: "hrtime" } as const; ``` ### Query permissions @@ -45,15 +45,15 @@ Check, by descriptor, if a permission is granted or not. ```ts // deno run --unstable --allow-read=/foo main.ts -const desc1 = { name: "read", path: "/foo" }; +const desc1 = { name: "read", path: "/foo" } as const; console.log(await Deno.permissions.query(desc1)); // PermissionStatus { state: "granted" } -const desc2 = { name: "read", path: "/foo/bar" }; +const desc2 = { name: "read", path: "/foo/bar" } as const; console.log(await Deno.permissions.query(desc2)); // PermissionStatus { state: "granted" } -const desc3 = { name: "read", path: "/bar" }; +const desc3 = { name: "read", path: "/bar" } as const; console.log(await Deno.permissions.query(desc3)); // PermissionStatus { state: "prompt" } ``` @@ -82,13 +82,13 @@ _[stronger than](https://www.w3.org/TR/permissions/#ref-for-permissiondescriptor More examples: ```ts -const desc1 = { name: "write" }; +const desc1 = { name: "write" } as const; // is stronger than -const desc2 = { name: "write", path: "/foo" }; +const desc2 = { name: "write", path: "/foo" } as const; -const desc3 = { name: "net" }; +const desc3 = { name: "net" } as const; // is stronger than -const desc4 = { name: "net", url: "127.0.0.1:8000" }; +const desc4 = { name: "net", url: "127.0.0.1:8000" } as const; ``` ### Request permissions @@ -98,13 +98,13 @@ Request an ungranted permission from the user via CLI prompt. ```ts // deno run --unstable main.ts -const desc1 = { name: "read", path: "/foo" }; +const desc1 = { name: "read", path: "/foo" } as const; const status1 = await Deno.permissions.request(desc1); // ⚠️ Deno requests read access to "/foo". Grant? [g/d (g = grant, d = deny)] g console.log(status1); // PermissionStatus { state: "granted" } -const desc2 = { name: "read", path: "/bar" }; +const desc2 = { name: "read", path: "/bar" } as const; const status2 = await Deno.permissions.request(desc2); // ⚠️ Deno requests read access to "/bar". Grant? [g/d (g = grant, d = deny)] d console.log(status2); @@ -129,7 +129,7 @@ Downgrade a permission from "granted" to "prompt". ```ts // deno run --unstable --allow-read=/foo main.ts -const desc = { name: "read", path: "/foo" }; +const desc = { name: "read", path: "/foo" } as const; console.log(await Deno.permissions.revoke(desc)); // PermissionStatus { state: "prompt" } ``` @@ -140,7 +140,7 @@ one granted on the CLI? ```ts // deno run --unstable --allow-read=/foo main.ts -const desc = { name: "read", path: "/foo/bar" }; +const desc = { name: "read", path: "/foo/bar" } as const; console.log(await Deno.permissions.revoke(desc)); // PermissionStatus { state: "granted" } ``` @@ -177,11 +177,11 @@ whichever _explicitly granted permission descriptor_ is _stronger than_ `desc`. ```ts // deno run --unstable --allow-read=/foo main.ts -const desc = { name: "read", path: "/foo/bar" }; +const desc = { name: "read", path: "/foo/bar" } as const; console.log(await Deno.permissions.revoke(desc)); // Insufficient. // PermissionStatus { state: "granted" } -const strongDesc = { name: "read", path: "/foo" }; +const strongDesc = { name: "read", path: "/foo" } as const; await Deno.permissions.revoke(strongDesc); // Good. console.log(await Deno.permissions.query(desc)); |