Method constructor

src/engine.ts:16–57

(
        private cmodule: LuaWasm,
        {
            openStandardLibs = true,
            injectObjects = false,
            enableProxy = true,
            traceAllocations = false,
            functionTimeout = undefined as number | undefined,
        }: CreateEngineOptions = {},
    )

    public global: Global

    public constructor(
        private cmodule: LuaWasm,
        {
            openStandardLibs = true,
            injectObjects = false,
            enableProxy = true,
            traceAllocations = false,
            functionTimeout = undefined as number | undefined,
        }: CreateEngineOptions = {},
    ) {
        this.global = new Global(this.cmodule, traceAllocations)

        // Generic handlers - These may be required to be registered for additional types.
        this.global.registerTypeExtension(0, createTableType(this.global))
        this.global.registerTypeExtension(0, createFunctionType(this.global, { functionTimeout }))

        // Contains the :await functionality.
        this.global.registerTypeExtension(1, createPromiseType(this.global, injectObjects))

        if (injectObjects) {
            // Should be higher priority than table since that catches generic objects along
            // with userdata so it doesn't end up a userdata type.
            this.global.registerTypeExtension(5, createNullType(this.global))
        }

        if (enableProxy) {
            // This extension only really overrides tables and arrays.
            // When a function is looked up in one of it's tables it's bound and then
            // handled by the function type extension.
            this.global.registerTypeExtension(3, createProxyType(this.global))
        } else {
            // No need to register this when the proxy is enabled.
            this.global.registerTypeExtension(1, createErrorType(this.global, injectObjects))
        }

        // Higher priority than proxied objects to allow custom user data without exposing methods.
        this.global.registerTypeExtension(4, createUserdataType(this.global))

        if (openStandardLibs) {
            this.cmodule.luaL_openlibs(this.global.address)
        }
    }

    /**
     * Executes Lua code from a string asynchronously.