feat(ses): Add Compartment load function

endojs · Jul 21, 2020 · 88264c0 · 88264c0
1 parent 0926a2d
commit 88264c0
Show file tree

Hide file tree

Showing 5 changed files with 16 additions and 0 deletions.
diff --git a/packages/ses/NEWS.md b/packages/ses/NEWS.md
@@ -10,6 +10,9 @@ User-visible changes in SES:
   by aliasing them to their non-locale equivalents. `localeCompare` had no builtin
   non-locale equivalent, so we provide one.
 * Adds a TypeScript definition for `harden`.
+* Adds the `load` method to `Compartment`.
+  Load allows a bundler or archiver to use the `Compartment` API to gather the
+  transitive dependencies of modules without executing them.
 
 ## Release 0.9.0 (13-July-2020)
 

diff --git a/packages/ses/src/compartment-shim.js b/packages/ses/src/compartment-shim.js
@@ -235,6 +235,16 @@ export class Compartment {
     });
   }
 
+  async load(specifier) {
+    if (typeof specifier !== 'string') {
+      throw new TypeError('first argument of load() must be a string');
+    }
+
+    assertModuleHooks(this);
+
+    return load(privateFields, moduleAnalyses, this, specifier);
+  }
+
   importNow(specifier) {
     if (typeof specifier !== 'string') {
       throw new TypeError('first argument of importNow() must be a string');

diff --git a/packages/ses/src/whitelist.js b/packages/ses/src/whitelist.js
@@ -1548,6 +1548,7 @@ export default {
     evaluate: fn,
     globalThis: getter,
     import: asyncFn,
+    load: asyncFn,
     importNow: fn,
     module: fn,
   },

diff --git a/packages/ses/test/compartment-instance.test.js b/packages/ses/test/compartment-instance.test.js
@@ -43,6 +43,7 @@ test('Compartment instance', t => {
       'evaluate',
       'import',
       'importNow',
+      'load',
       'module',
       'globalThis',
       'toString',

diff --git a/packages/ses/test/compartment-prototype.test.js b/packages/ses/test/compartment-prototype.test.js
@@ -19,6 +19,7 @@ test('Compartment prototype', t => {
       'evaluate',
       'import',
       'importNow',
+      'load',
       'module',
       'globalThis',
       'toString',