Class: LoaderStrategy<T>

A multi-purpose feature-complete loader strategy supporting multi-piece modules as well as supporting both ECMAScript Modules and CommonJS with reloading support.

Type Parameters

Type Parameter
T extends Piece

Implements

• ILoaderStrategy<T>

Constructors

new LoaderStrategy()

new LoaderStrategy<T>(): LoaderStrategy<T>

Returns

LoaderStrategy<T>

Defined in

projects/pieces/src/lib/strategies/LoaderStrategy.ts:31

Properties

clientUsesESModules

clientUsesESModules: boolean

Defined in

projects/pieces/src/lib/strategies/LoaderStrategy.ts:27

---

supportedExtensions

supportedExtensions: string[]

Defined in

projects/pieces/src/lib/strategies/LoaderStrategy.ts:28

Methods

filter()

filter(path: string): FilterResult

Retrieves the name and the extension of the specified file path.

Parameters

Parameter	Type	Description
path	string	The path of the file to be processed.

Returns

FilterResult

A ModuleData on success, otherwise null to stop the store from processing the path.

Example

// ts-node support
class MyStrategy extends LoaderStrategy {
  filter(path) {
    const extension = extname(path);
    if (!['.js', '.ts'].includes(extension)) return null;
    const name = basename(path, extension);
    return { extension, name };
  }
}

Implementation of

ILoaderStrategy.filter

Defined in

projects/pieces/src/lib/strategies/LoaderStrategy.ts:38

---

load()

load(store: Store<T, never>, file: HydratedModuleData): ILoaderResult<T>

The load hook, use this to override the loader.

Parameters

Parameter	Type
store	Store<T, never>
file	HydratedModuleData

Returns

ILoaderResult<T>

Example

class MyStrategy extends LoaderStrategy {
  load(store, file) {
    // ...
  }
}

Implementation of

ILoaderStrategy.load

Defined in

projects/pieces/src/lib/strategies/LoaderStrategy.ts:69

---

onError()

onError(error: Error, path: string): void

Parameters

Parameter	Type	Description
error	Error	The error that was thrown.
path	string	The path of the file that caused the error to be thrown.

Returns

void

Implementation of

ILoaderStrategy.onError

Defined in

projects/pieces/src/lib/strategies/LoaderStrategy.ts:112

---

onLoad()

onLoad(store: Store<T, never>, piece: T): unknown

Called after a piece has been loaded, but before Piece.onLoad and Map.set.

Parameters

Parameter	Type	Description
store	Store<T, never>	The store that holds the piece.
piece	T	The piece that was loaded.

Returns

unknown

Implementation of

ILoaderStrategy.onLoad

Defined in

projects/pieces/src/lib/strategies/LoaderStrategy.ts:92

---

onLoadAll()

onLoadAll(store: Store<T, never>): unknown

Called after all pieces have been loaded.

Parameters

Parameter	Type	Description
store	Store<T, never>	The store that loaded all pieces.

Returns

unknown

Implementation of

ILoaderStrategy.onLoadAll

Defined in

projects/pieces/src/lib/strategies/LoaderStrategy.ts:97

---

onUnload()

onUnload(store: Store<T, never>, piece: T): unknown

Called after a piece has been unloaded or overwritten by a newly loaded piece.

Parameters

Parameter	Type	Description
store	Store<T, never>	The store that held the piece.
piece	T	The piece that was unloaded.

Returns

unknown

Implementation of

ILoaderStrategy.onUnload

Defined in

projects/pieces/src/lib/strategies/LoaderStrategy.ts:102

---

onUnloadAll()

onUnloadAll(store: Store<T, never>): unknown

Called after all pieces have been unloaded.

Parameters

Parameter	Type	Description
store	Store<T, never>	The store that unloaded all pieces.

Returns

unknown

Implementation of

ILoaderStrategy.onUnloadAll

Defined in

projects/pieces/src/lib/strategies/LoaderStrategy.ts:107

---

preload()

preload(file: ModuleData): AsyncPreloadResult<T>

The pre-load hook, use this to override the loader.

Parameters

Parameter	Type
file	ModuleData

Returns

AsyncPreloadResult<T>

Examples

// CommonJS support:
class MyStrategy extends LoaderStrategy {
  preload(path) {
    return require(path);
  }
}

// ESM support:
class MyStrategy extends LoaderStrategy {
  preload(file) {
    return import(file.path);
  }
}

Implementation of

ILoaderStrategy.preload

Defined in

projects/pieces/src/lib/strategies/LoaderStrategy.ts:53

---

walk()

walk(store: Store<T, never>, path: string, logger?: null | StoreLogger): AsyncIterableIterator<string>

Walks the specified path and returns an async iterator of all the files' paths.

Parameters

Parameter	Type	Description
store	Store<T, never>	The store that is walking the path.
path	string	The path to recursively walk.
logger?	null | StoreLogger	The logger to use when walking the path, if any.

Returns

AsyncIterableIterator<string>

Implementation of

ILoaderStrategy.walk

Defined in

projects/pieces/src/lib/strategies/LoaderStrategy.ts:116