2 files changed, 22 insertions, 0 deletions
diff --git a/cli/dts/lib.deno.unstable.d.ts b/cli/dts/lib.deno.unstable.d.ts
index 0ed27c5d5..b8eb886e4 100644
--- a/cli/dts/lib.deno.unstable.d.ts
+++ b/cli/dts/lib.deno.unstable.d.ts
@@ -317,6 +317,18 @@ declare namespace Deno {
    */
   export function getUid(): number | null;
 
+  /** **Unstable** new API. yet to be vetted.
+   *
+   * Returns the group id of the process on POSIX platforms. Returns null on windows.
+   *
+   * ```ts
+   * console.log(Deno.getGid());
+   * ```
+   *
+   * Requires `allow-env` permission.
+   */
+  export function getGid(): number | null;
+
   /** All possible types for interfacing with foreign functions */
   export type NativeType =
     | "void"
diff --git a/cli/tests/unit/os_test.ts b/cli/tests/unit/os_test.ts
index 6ed1126f1..b5ff6f29f 100644
--- a/cli/tests/unit/os_test.ts
+++ b/cli/tests/unit/os_test.ts
@@ -204,3 +204,13 @@ Deno.test({ permissions: { env: true } }, function getUid() {
     assert(uid > 0);
   }
 });
+
+Deno.test({ permissions: { env: true } }, function getGid() {
+  if (Deno.build.os === "windows") {
+    assertEquals(Deno.getGid(), null);
+  } else {
+    const gid = Deno.getGid();
+    assert(typeof gid === "number");
+    assert(gid > 0);
+  }
+});