REPL
像 Node.js REPL 一样，AdonisJS 提供了一个应用程序感知的 REPL，以便你从命令行与应用程序进行交互。你可以使用 node ace repl 命令启动 REPL 会话。
node ace repl
除了标准的 Node.js REPL 之外，AdonisJS 还提供了以下功能。
- 导入并执行 TypeScript 文件。
- 简写方法，用于导入容器服务，如
router、helpers、hash服务等。 - 简写方法，用于使用 IoC 容器 创建类实例。
- 可扩展的 API，用于添加自定义方法和 REPL 命令。
与 REPL 交互
启动 REPL 会话后，你将看到一个交互式提示符，你可以在其中编写有效的 JavaScript 代码并按回车键执行。代码的输出将打印在下一行。
如果你想输入多行代码，可以通过输入 .editor 命令进入编辑模式。按 Ctrl+D 执行多行语句，或按 Ctrl+C 取消并退出编辑模式。
> (js) .editor
# // Entering editor mode (Ctrl+D to finish, Ctrl+C to cancel)
访问最后执行命令的结果
如果你忘记将语句的值分配给变量，可以使用 _ 变量来访问它。例如：
> (js) helpers.string.generateRandom(32)
# 'Z3y8QQ4HFpYSc39O2UiazwPeKYdydZ6M'
> (js) _
# 'Z3y8QQ4HFpYSc39O2UiazwPeKYdydZ6M'
> (js) _.length
# 32
> (js)
访问最后执行命令引发的错误
你可以使用 _error 变量访问前一条命令引发的异常。例如：
> (js) helpers.string.generateRandom()
> (js) _error.message
# 'The value of "size" is out of range. It must be >= 0 && <= 2147483647. Received NaN'
搜索历史记录
REPL 历史记录保存在用户主目录中的 .adonisjs_v6_repl_history 文件中。
你可以按向上箭头 ↑ 键循环浏览历史命令，或按 Ctrl+R 在历史记录中搜索。
退出 REPL 会话
你可以通过输入 .exit 或按两次 Ctrl+C 来退出 REPL 会话。AdonisJS 将在关闭 REPL 会话之前执行优雅关闭。
此外，如果你修改了代码库，必须退出并重新启动 REPL 会话，以便应用新的更改。
导入模块
Node.js 不允许在 REPL 会话中使用 import 语句。因此，你必须使用动态的 import 函数，并将输出分配给变量。例如：
const { default: User } = await import('#models/user')
你可以使用 importDefault 方法访问默认导出，而无需解构导出。
const User = await importDefault('#models/user')
辅助方法
辅助方法是你可以执行的快捷函数，用于执行特定操作。你可以使用 .ls 命令查看可用方法的列表。
> (js) .ls
# GLOBAL METHODS:
importDefault 返回模块的默认导出
make 使用 "container.make" 方法创建类实例
loadApp 在 REPL 上下文中加载 "app" 服务
loadEncryption 在 REPL 上下文中加载 "encryption" 服务
loadHash 在 REPL 上下文中加载 "hash" 服务
loadRouter 在 REPL 上下文中加载 "router" 服务
loadConfig 在 REPL 上下文中加载 "config" 服务
loadTestUtils 在 REPL 上下文中加载 "testUtils" 服务
loadHelpers 在 REPL 上下文中加载 "helpers" 模块
clear 从 REPL 上下文中清除属性
p 将函数 Promise 化。类似于 Node.js 的 "util.promisify"
向 REPL 添加自定义方法
你可以使用 repl.addMethod 向 REPL 添加自定义方法。该方法将名称作为第一个参数，将实现回调作为第二个参数。
为了演示，让我们创建一个 preload 文件，并定义一个方法从 ./app/models 目录导入所有模型。
node ace make:preload repl -e=repl
import app from '@adonisjs/core/services/app'
import repl from '@adonisjs/core/services/repl'
import { fsImportAll } from '@adonisjs/core/helpers'
repl.addMethod('loadModels', async () => {
const models = await fsImportAll(app.makePath('app/models'))
repl.server!.context.models = models
repl.notify('Imported models. You can access them using the "models" property')
repl.server!.displayPrompt()
})
你可以将以下选项作为第三个参数传递给 repl.addMethod 方法。
description：在帮助输出中显示的人类可读描述。usage：定义方法使用代码片段。如果未设置，将使用方法名称。
完成后，你可以重新启动 REPL 会话并执行 loadModels 方法以导入所有模型。
node ace repl
# Type ".ls" to a view list of available context methods/properties
> (js) await loadModels()