支持 async/await
在正式支持 async/await 之前,云函数(不管是否是 async 函数)通过 callback 函数来将执行结果返回给调用方。而现在 async 函数可以直接使用 return 将结果返回。
使用 async + return 时,不要同时使用 callback(除非你对 Node JS 事件循环与 async/await 十分了解),否则可能产生非预期的结果。
非 async 函数无法使用 return。
云函数执行与结果返回机制,请参考Node.js 事件循环
云函数支持以下两种风格的写法:
- 使用 callback
exports.main = function getProduct(event, callback) {
let tableName = 'product'
let recordID = '59897882ff650c0477f00485'
let Product = new BaaS.TableObject(tableName)
Product.get(recordID).then(product => {
callback(null, product)
}).catch(err => {
callback(err)
})
}
exports.main = async function getProduct(event, callback) {
try {
let tableName = 'product'
let recordID = '59897882ff650c0477f00485'
let Product = new BaaS.TableObject(tableName)
let product = await Product.get(recordID)
callback(null, product)
} catch (err) {
callback(err)
}
}
- 使用 async + return
exports.main = async function getProduct(event) {
let tableName = 'product'
let recordID = '59897882ff650c0477f00485'
let Product = new BaaS.TableObject(tableName)
return await Product.get(recordID)
}
返回错误信息
使用 async + return 风格,云函数返回错误信息的方式与 callback 风格有所不同,区别如下:
- callback 风格
exports.main = function (event, callback) {
callback(new Error('error')) // or callback('error')
}
返回值:
{
error: {
message: 'error',
stack: '...',
},
code: 1,
data: null,
}
- async + return 风格
exports.main = async function (event) {
throw new Error('error')
}
返回值:
{
error: {
message: 'error',
stack: '...',
},
code: 1,
data: null,
}
async 函数中单独写 return 或 return undefined,将会被忽略。例如:
// 该云函数会执行超时
exports.main = async function (event) {
return
}
// 该云函数会执行超时
exports.main = async function (event) {
return undefined
}
// 该云函数会执行并返回 {error: {}, code: 0, data: null}
exports.main = async function (event) {
return null
}