Documentation
¶
Index ¶
- Constants
- Variables
- func DefaultSourceLoader(filename string) ([]byte, error)
- func RegisterCoreModule(name string, loader ModuleLoader)
- func RegisterNativeModule(name string, loader ModuleLoader)
- func Require(runtime *js.Runtime, name string) js.Value
- type ModuleLoader
- type Option
- type Registry
- type RequireModule
- type SourceLoader
Constants ¶
const NodePrefix = "node:"
Variables ¶
Functions ¶
func DefaultSourceLoader ¶
DefaultSourceLoader is used if none was set (see WithLoader()). It simply loads files from the host's filesystem.
func RegisterCoreModule ¶
func RegisterCoreModule(name string, loader ModuleLoader)
RegisterCoreModule registers a nodejs core module. If the name does not start with "node:", the module will also be loadable as "node:<name>". Hence, for "builtin" modules (such as buffer, console, etc.) the name should not include the "node:" prefix, but for prefix-only core modules (such as "node:test") it should include the prefix.
func RegisterNativeModule ¶
func RegisterNativeModule(name string, loader ModuleLoader)
RegisterNativeModule registers a module that isn't loaded through a SourceLoader, but rather through a provided ModuleLoader. Typically, this will be a module implemented in Go (although theoretically it can be anything, depending on the ModuleLoader implementation). Such modules take precedence over modules loaded through a SourceLoader, i.e. if a module name resolves as native, the native module is loaded, and the SourceLoader is not consulted. The binding is global and affects all instances of Registry. It should be called from a package init() function as it may not be used concurrently with require() calls. For registry-specific bindings see Registry.RegisterNativeModule.
Types ¶
type Option ¶
type Option func(*Registry)
func WithGlobalFolders ¶
WithGlobalFolders appends the given paths to the registry's list of global folders to search if the requested module is not found elsewhere. By default, a registry's global folders list is empty. In the reference Node.js implementation, the default global folders list is $NODE_PATH, $HOME/.node_modules, $HOME/.node_libraries and $PREFIX/lib/node, see https://nodejs.org/api/modules.html#modules_loading_from_the_global_folders.
func WithLoader ¶
func WithLoader(srcLoader SourceLoader) Option
WithLoader sets a function which will be called by the require() function in order to get a source code for a module at the given path. The same function will be used to get external source maps. Note, this only affects the modules loaded by the require() function. If you need to use it as a source map loader for code parsed in a different way (such as runtime.RunString() or eval()), use (*Runtime).SetParserOptions()
type Registry ¶
Registry contains a cache of compiled modules which can be used by multiple Runtimes
func NewRegistry ¶
func NewRegistryWithLoader ¶
func NewRegistryWithLoader(srcLoader SourceLoader) *Registry
func (*Registry) Enable ¶
func (r *Registry) Enable(runtime *js.Runtime) *RequireModule
Enable adds the require() function to the specified runtime.
func (*Registry) RegisterNativeModule ¶
func (r *Registry) RegisterNativeModule(name string, loader ModuleLoader)
type RequireModule ¶
type RequireModule struct {
// contains filtered or unexported fields
}
type SourceLoader ¶
SourceLoader represents a function that returns a file data at a given path. The function should return ModuleFileDoesNotExistError if the file either doesn't exist or is a directory. This error will be ignored by the resolver and the search will continue. Any other errors will be propagated.
Source Files