Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

bricss/dopant

Repository files navigation

The aerogel-weight & dead-simple resource loader 🚚

This package provides a lightweight dynamic resource loader for web browsers.

Abstract

  • Promise-based API ⏳
  • Parallel by default, ordered when required ⚑
  • Supports all <link> relations (preconnect, preload, stylesheet, etc.) πŸ”—
  • Supports all <script> types (importmap, module, nomodule, etc.) πŸ“ƒ
  • Zero dependencies πŸ—½

Prerequisites

  • Node.js >= 20.0.0

Installation

npm install dopant --save

Usage

import dopant from 'dopant';
await dopant(
 '/assets/css/layout.css',
 '/assets/js/main.js',
 ['/assets/js/importmap.json', { type: 'importmap' }],
 ['/assets/js/module.js', { defer: true, type: 'module' }],
 [
 '/assets/webfonts/font.woff2',
 {
 as: 'font',
 rel: 'preload',
 type: 'font/woff2',
 }
 ],
);

API

dopant(...resources)

  • ...resources {string | [string, attrs]} Resources w/wo extra attributes to load into the web page
  • Returns: Promise that resolves to a list of resolutions

Behavior

  • CSS files default to rel="stylesheet"
  • If rel is provided, a <link> element is created
  • Otherwise, a <script> element is created
  • Scripts default to async: true (unless overridden or defer: true is set)

For more details, please check tests in the repository.

About

The aerogel-weight & dead-simple resource loader 🚚

Topics

Resources

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

AltStyle γ«γ‚ˆγ£γ¦ε€‰ζ›γ•γ‚ŒγŸγƒšγƒΌγ‚Έ (->γ‚ͺγƒͺγ‚ΈγƒŠγƒ«) /