2

我想有一种方法来为某些 Javascript 方法指定哪些属性是必需的,它们应该匹配什么模式,以及如果它们不匹配如何响应。

这是因为它会导致大量重复代码来检查方法级别的必需参数和可选参数。

举这个例子。在这里,我想建立一个灯箱。如果他们给我发送一个字符串,我将显示一个仅包含内容的灯箱。如果他们向我发送选项对象,我会查找“标题”和“内容”。能够以某种标准化的方式指定这一点不是很好吗?

// Static method for generating a lightbox
// callerOptions = '' //if sent a string, the lightbox displays it with no title
// callerOptions = {
//      content: '' // required popup contents. can be HTML or text.
//  ,   title: '' // required title for the lightbox
//  ,   subtitle: '' // optional subtitle for lightbox
//  }
lightbox = function (callerOptions) {
    if (!callerOptions) {
        log.warn(_myName + ': calling me without a message to display or any options won\'t do anything');
        return;
    }

    // If they send us a string, assume it's the popup contents
    if (typeof(callerOptions) === 'string') {
        this.options = {};
        this.options.content = callerOptions;

    // Otherwise assume they sent us a good options object
    } else {
        this.options = callerOptions;
    }

    _build();
    _contentLoaded();
};

我希望能够使用一些我从未听说过的库来做这样的事情:

// Maybe this is what it looks like with a method signature enforcement library
lightbox = function (callerOptions) {
    TheEnforcer(
    ,   {   valid: [
                'string' // assumes that it is testing type against arguments by convention
            ,   'typeof([0].title) === "string" && typeof([0].content) === "string"'
            ]
        }
    });

    // If they send us a string, assume it's the popup contents
    if (typeof(callerOptions) === 'string') {
        this.options = { 'content': callerOptions };

    // Otherwise we know they sent us a good options object
    } else {
        this.options = callerOptions;
    }

    _build();
    _contentLoaded();
};

有没有人见过这样的 Javascript 库?也许内置于 1000 个 JS MV* 框架之一?

编辑:似乎这通常由 MV* 框架处理。Backbone.js 的模型属性同时具有验证值和默认值。我认为这些可以用来满足或几乎满足我在这里介绍的用例。

4

2 回答 2

2

(这本来是一个评论,但它比预期的要长。)

我知道这样的功能有时会很有用,但我认为应该尽可能避免使用。我认为 ECMA 标准永远不应该包括这一点。

举个例子:灯箱标题和内容是必需的。为什么?为什么不显示一个没有标题或内容的空灯箱?在我看来,这是一个不错的后备方案。如果你正在构建一个 API,任何使用它的人都可以检查空标题和内容,如果需要,就不要调用灯箱函数。另外,我不喜欢尝试在 JS 中强制执行类型的想法。

我认为这与 jQuery 完全不同。他们只是提供了一个可链接的包装对象(里面有一堆有用的方法),并且支持某种编码/语法风格,这就是 jQuery 的大部分内容。它使语言看起来更简单,不像类型和方法签名强制 - 绝对不是“尽可能简单”(对此感到抱歉)。

于 2012-04-19T03:14:09.443 回答
0

我想这有两个部分,哲学/架构和实现。

在哲学方面,我认为没有什么比描述每种方法需要和不需要的明确期望和错误消息更简单的了(对于我的 API 用户,而不是我,API 开发人员)。

在实施方面,这就是问题的最初含义,我想我必须自己回答。Backbone.js 的模型,尤其是 .validate 部分,似乎很好地满足了这一需求。我还没有使用它们,但这是迄今为止我发现的唯一类似的东西。

http://documentcloud.github.com/backbone/#Model-validate

编辑:另一个解决方案可能是编译时间。Google Closure Compiler 似乎可以很好地处理这个问题:https ://developers.google.com/closure/compiler/docs/js-for-compiler

于 2012-04-21T19:54:16.763 回答