Insomnia交互式变量输入方法

在进行API测试时，我们常常会遇到一些需要临时输入动态值的场景。

例如：临时的用户Token、一次性的订单ID，或者一个手动指定的时间戳。

如果每次都去修改代码或者环境变量，不仅繁琐，也容易出错。那么，有没有一种更灵活、更交互式的方法呢？

答案是肯定的。借助Insomnia，我们可以轻松实现发送请求前的动态变量输入。

具体来说，主要有三种路径可以实现这个目标：

• 利用内置的脚本函数触发原生弹窗
• 通过环境变量编辑界面手动交互
• 安装插件来获得更强大的输入能力

下面我们来逐一拆解。

一、使用内置 prompt() 函数触发弹窗

这是最直接的方法。Insomnia允许在请求的“Pre-request Script”中调用JavaScript的prompt()函数。

当脚本执行时，会弹出一个系统原生的输入框，等待用户输入。之后，这个值可以被赋值给环境变量，并应用到请求的各个部分。

操作步骤：

1. 在Insomnia中找到你的目标请求，点击右上角的“”按钮，选择“Edit Request”。
2. 切换到“Pre-request Script”标签页。
3. 输入类似下面的代码：

   const userInput = prompt("请输入订单ID：");

   insomnia.setEnvironmentVariable("order_id", userInput);

这段代码的作用是：

• 弹出一个提示为“请输入订单ID：”的对话框。
• 将用户输入的内容存储到名为“order_id”的环境变量中。

最后，在请求的URL或Body中，通过{{order_id}}的格式引用这个变量即可。

当你点击“Send”发送请求时，Insomnia会先运行这段脚本，弹出输入框，等待你填写并确认后，才会执行实际的请求。

二、通过环境变量 + 手动编辑触发交互

如果你觉得写脚本有点麻烦，或者只是需要频繁切换少数几个固定的变量，那么这个方法可能更适合你。

它的核心思路是：利用Insomnia环境变量本身的编辑功能，在发送请求前手动激活编辑界面，实现一种“类交互”的效果。

具体操作：

1. 进入“Environments”面板，创建或选中一个环境（比如“Development”）。
2. 在这个环境的变量列表里，添加一项。例如：
   • 名称设为user_token
   • 值可以留空，或填上占位符（如“INPUT_REQUIRED”）以作提示。
3. 在你的请求中，使用{{user_token}}这个占位符来引用它。

最关键的一步：

当你需要发送请求时，不要直接点击“Send”按钮，而是点击它旁边的下拉箭头，选择“Edit Environment Variables before sending”。

这时，Insomnia会弹出一个变量编辑窗口，你可以直接修改user_token的值，确认后请求便会带着新值发出。

这种方法省去了编写脚本的步骤，对于简单的、可预见的变量输入场景，效率非常高。

三、结合插件实现增强型 Prompt 输入

前面两种方法虽然有效，但可能还不够强大。

例如：原生的prompt()函数在某些Insomnia版本或特定环境下可能会被拦截；或者，你可能需要一次输入多个字段，甚至希望对输入内容进行格式校验（比如邮箱、数字）。

这时候，插件市场就能派上用场了。“Insomnia Plugin Prompt”这款插件可以提供更稳定、功能更丰富的弹窗支持。

安装步骤：

1. 打开Insomnia，进入“Preferences” → “Plugins” → “Browse Plugins”。
2. 在搜索框中输入prompt。
3. 找到并安装名为“Insomnia Plugin Prompt”的插件。
4. 安装完成后，重启Insomnia使其生效。

使用方式：

与内置函数类似，但API更强大。你可以在Pre-request Script中这样写：

const result = await insomnia.prompt("请输入邮箱", { type: "email" });

insomnia.setEnvironmentVariable("target_email", result.value);

注意：

• 这里使用了insomnia.prompt这个插件提供的异步方法。
• 通过{ type: "email" }参数指定了输入类型为邮箱格式，插件会自动进行基础的格式校验。
• 输入的值会存储在result.value中，随后被设置到环境变量target_email里。
• 在请求中，照常使用{{target_email}}引用即可。

这款插件还支持多字段表单式弹窗，让你能在一个弹窗内填写多个相关变量，大大提升了复杂场景下的输入体验。

总结

无论是追求简单快捷，还是需要稳定强大的功能，Insomnia都提供了相应的解决方案来满足你在API测试前动态输入变量的需求。

根据你的具体场景，选择最合适的一种方式，就能让测试工作流变得更加灵活和高效。