Module metadata

Concepts

  • import.meta can provide information on the context of the module.
  • The boolean import.meta.main will let you know if the current module is the program entry point.
  • The string import.meta.url will give you the URL of the current module.
  • The string Deno.mainModule will give you the URL of the main module entry point, i.e. the module invoked by the deno runtime.

Example

The example below uses two modules to show the difference between import.meta.url, import.meta.main and Deno.mainModule. In this example, module_a.ts is the main module entry point:

  1. /**
  2.  * module_b.ts
  3.  */
  4. export function outputB() {
  5.   console.log("Module B's import.meta.url", import.meta.url);
  6.   console.log("Module B's mainModule url", Deno.mainModule);
  7.   console.log(
  8.     "Is module B the main module via import.meta.main?",
  9.     import.meta.main,
  10.   );
  11. }
  1. /**
  2.  * module_a.ts
  3.  */
  4. import { outputB } from "./module_b.ts";
  6. function outputA() {
  7.   console.log("Module A's import.meta.url", import.meta.url);
  8.   console.log("Module A's mainModule url", Deno.mainModule);
  9.   console.log(
  10.     "Is module A the main module via import.meta.main?",
  11.     import.meta.main,
  12.   );
  13. }
  15. outputA();
  16. console.log("");
  17. outputB();

If module_a.ts is located in /home/alice/deno then the output of deno run --allow-read module_a.ts is:

  1. Module A's import.meta.url file:///home/alice/deno/module_a.ts
  2. Module A's mainModule url file:///home/alice/deno/module_a.ts
  3. Is module A the main module via import.meta.main? true
  5. Module B's import.meta.url file:///home/alice/deno/module_b.ts
  6. Module B's mainModule url file:///home/alice/deno/module_a.ts
  7. Is module B the main module via import.meta.main? false