rekey
V2EX  ›  Node.js

node.js异步操作多,怎么写注释?

  •  
  •   rekey · Jan 11, 2014 · 8539 views
    This topic created in 4514 days ago, the information mentioned may be changed or developed.
    如题.
    类似如下代码.返回的是一个Promise,如何明确的通过注释告知返回值?

    /**
    * 检测图片信息
    * @param {String} imagePath 需要检测的图片路径
    * @type {Object}
    * @returns {Object} 通过Promise对象返回图片相关信息
    */
    function identify(imagePath) {
    var deferred = when.defer();
    imagemagick.identify(imagePath, function (err, data) {
    if (err) {
    deferred.reject({
    'errno' : 3,
    'message' : 'file is not a image.'
    });
    } else {
    var channel_statistics = data['channel statistics'];
    deferred.resolve({
    size : data.filesize,
    width : data.width,
    height : data.height,
    type : mimeTypes[data.format],
    mean : [channel_statistics.red.mean.replace(/\.[\d]+ \(.*\)/, ''), channel_statistics.green.mean.replace(/\.[\d]+ \(.*\)/, ''), channel_statistics.blue.mean.replace(/\.[\d]+ \(.*\)/, '')]
    });
    }
    });
    return deferred.promise;
    }
    7 replies    1970-01-01 08:00:00 +08:00
    tamamaxox
        1
    tamamaxox  
       Jan 11, 2014 via Android
    when.js
    tamamaxox
        2
    tamamaxox  
       Jan 11, 2014 via Android
    哦..不就备注了resolve吗
    rekey
        3
    rekey  
    OP
       Jan 11, 2014
    @tamamaxox 好吧,突然想通了.如果代码过长而看不到resolve应该也是不科学的.

    刚刚YUIDoc和jsdoc都试了试.貌似@example都会导致注释太长.

    纠结啊.
    XadillaX
        4
    XadillaX  
       Jan 13, 2014
    用async吧
    acecode
        5
    acecode  
       Jan 13, 2014
    异步操作最好用个异步库整理下,async, Q 啊神马的
    rekey
        6
    rekey  
    OP
       Jan 14, 2014
    @XadillaX 嗯,这些都有做.我现在只是想探讨怎么写注释.
    rekey
        7
    rekey  
    OP
       Jan 14, 2014
    @acecode var deferred = when.defer(); 代码大概第二行就是这个,您是不是偶尔也需要多了解异步处理的方式?
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Solana   ·   1024 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 316ms · UTC 18:58 · PVG 02:58 · LAX 11:58 · JFK 14:58
    ♥ Do have faith in what you're doing.