使用特殊注释对对象进行智能感知

Question

在 Sublime 或 VS Code 中，您可以定义一个特殊的注释（例如 DocBlockr 或 JSDocs），Intellisense 将识别并为您提供智能工具提示功能。

我有一个带有选项参数的函数。这是一个对象，可以有几个属性，可以包含函数、字符串、整数等。一个例子是：

function foo(options){
    options = options || {};

    if(options.foo){
        console.log(options.foo);
    }
    if(options.bar) {
        console.log(options.bar());
    }
}
foo({foo: 'foo', bar: function(){return 'bar';}});

我可以添加一个 DocBlockr 注释，但这只会产生一个工具提示，表明它需要一个对象。

是否可以对该选项对象进行某种定义，以便使用智能感知弹出？

Answer 1

对于 Sublime Text 3，您可以使用我的 JavaScript Enhancement 插件（您也可以在 Package Control 上找到它）将它变成一个 JavaScript IDE（它使用 Flow 在兜帽）。在你的情况下，使用Flow type annotations，你可以使用这个代码来得到你想要的：

//@flow

function foo(options /*: { foo: string, bar: function} */){
    options = options || {};

    if(options.foo){
        console.log(options.foo);
    }    
    if(options.bar) {
        console.log(options.bar());
    }
}

foo()

因此，在 Sublime Text 3 编辑器中，您将得到如下内容：

也在多行（/* :需要在参数的同一行）：

此外，该插件不仅提供智能 javascript 自动完成功能，还提供许多有关创建、开发和管理 javascript 项目的功能（实时错误、代码重构等）。