modules

Documentation

Index

• func GetJSModules() map[string]interface{}
• func Register(name string, mod interface{})
• type Exports
• type HasModuleInstancePerVU
• type Instance
• type Module
• type VU

Functions

func GetJSModules

func GetJSModules() map[string]interface{}

GetJSModules returns a map of all registered js modules

func Register

func Register(name string, mod interface{})

Register the given mod as an external JavaScript module that can be imported by name. The name must be unique across all registered modules and must be prefixed with "k6/x/", otherwise this function will panic.

Types

type Exports

type Exports struct {
	// Default is what will be the `default` export of a module
	Default interface{}
	// Named is the named exports of a module
	Named map[string]interface{}
}

Exports is representation of ESM exports of a module

type HasModuleInstancePerVU

type HasModuleInstancePerVU interface {
	NewModuleInstancePerVU() interface{}
}

HasModuleInstancePerVU should be implemented by all native Golang modules that would require per-VU state. k6 will call their NewModuleInstancePerVU() methods every time a VU imports the module and use its result as the returned object.

type Instance

type Instance interface {
	Exports() Exports
}

Instance is what a module needs to return

type Module

type Module interface {
	// NewModuleInstance will get modules.VU that should provide the module with a way to interact with the VU
	// This method will be called for *each* require/import and should return an unique instance for each call
	NewModuleInstance(VU) Instance
}

Module is the interface js modules should implement in order to get access to the VU

type VU

type VU interface {
	// Context return the context.Context about the current VU
	Context() context.Context

	// InitEnv returns common.InitEnvironment instance if present
	InitEnv() *common.InitEnvironment

	// State returns lib.State if any is present
	State() *lib.State

	// Runtime returns the goja.Runtime for the current VU
	Runtime() *goja.Runtime
}

VU gives access to the currently executing VU to a module Instance