stabilize Deno.cwd and require --allow-read (#5068)

1 files changed, 14 insertions, 0 deletions

diff --git a/cli/js/lib.deno.ns.d.ts b/cli/js/lib.deno.ns.d.ts
index 45730acbc..6adaf26ef 100644
--- a/cli/js/lib.deno.ns.d.ts
+++ b/cli/js/lib.deno.ns.d.ts
@@ -144,6 +144,20 @@ declare namespace Deno {
    */
   export function chdir(directory: string): void;
 
+  /**
+   * Return a string representing the current working directory.
+   *
+   * If the current directory can be reached via multiple paths (due to symbolic
+   * links), `cwd()` may return any one of them.
+   *
+   *       const currentWorkingDirectory = Deno.cwd();
+   *
+   * Throws `Deno.errors.NotFound` if directory not available.
+   *
+   * Requires --allow-read
+   */
+  export function cwd(): string;
+
   export enum SeekMode {
     Start = 0,
     Current = 1,