API Host BuiltInModules

BuiltInModules

AuroraScript 随附原生模块的目录。

命名空间：AuroraScript.Runtime.Package。类型：static class。

返回 .NET 宿主 API 参考

概述

随附的原生模块是显式能力。EngineOptions.Default 不启用任何模块。仅选择应用所需的文件系统或网络访问，然后在脚本代码中导入已启用的裸路径。

using AuroraScript.Runtime.Package;

var options = EngineOptions.Default.WithBuiltIns(builtIns =>
{
    builtIns.Add(BuiltInModules.FileSystem);
    builtIns.Add(BuiltInModules.HttpClient);
});

属性

FileSystem

static BuiltInModuleDefinition FileSystem

启用 fs 导入及 fs 中记录的 API。

import fs from "fs";

HttpClient

static BuiltInModuleDefinition HttpClient

启用 http 导入及其在 http 中记录的同步与回调 API。

import http from "http";

解析与隔离

• 已启用的裸路径在配置的项目源解析器之前解析。
• 相对导入（如 ./fs 和 ../http）仍使用项目源。
• 内置模块源是依赖项，不会由无参 BuildAsync() 枚举为项目入口。
• 模块对象在引擎和脚本域之间隔离。
• 在一个 EngineOptions 实例上选择模块不会全局启用它。

两个模块都授予语言运行时之外的访问权限。应将其视为应用能力，而非无害的工具库；不要为不受信任的脚本启用它们，除非有适当的进程或操作系统沙箱。