What's New

New Node.js 8 runtime for IBM Cloud Functions

Share this post:

Introducing a new runtime for JavaScript IBM Cloud Functions based on Node.js version 8. Now you can take advantage of the new features that are offered by the recently released Node.js version 8 on Long Term Support (LTS).

This new runtime comes with pre-installed npm packages (bm_db, ibm-cos-sdk, cloudant, watson-developer-cloud) that are useful when integrating serverless functions with IBM Cloud services. For more details on the Node.js 8 environment, check the documentation.

What’s new in Node.js version 8

The next major release of Node.js brings a range or significant changes and additions for JavaScript users. This article highlights the most significant changes and features.

With version 6 of Node.js, you are taking advantage of ES2015 language specification, such as Object destructuring. Now with version 8 of Node.js, you can leverage more language features in your IBM Functions, like JavaScript ES2017 async functions, which makes it easier to write code that can use and create Promises.

Using async functions, waiting for a Promise to resolve is as simple as typing await before it, and proceeding as if the value were synchronously available (without using callbacks).

Example

In this easy to follow example, you can see how to use async and await with IBM Db2 Warehouse on Cloud service.

1. Create a JavaScript file “Employees.js” with the following code:

   const ibmdb = require('ibm_db')
   const queryString = 'SELECT FIRST_NAME, LAST_NAME, EMAIL from GOSALESHR.employee FETCH FIRST 3 ROWS ONLY'
   async function main ({
   __bx_creds: { dashDB: { ssldsn } }
   }) {
     let connection, result, rows
     try {
      connection = await ibmdb.open(ssldsn)
      rows = await connection.query(queryString)
      connection.close()
      result = { employees: rows }
    } catch (err) {
      console.error(err.message)
      result = { message: err.message }
    }
    return result
   };

2. Deploy your function by using the CLI, and give it the name “Employees”.

bx wsk action update Employees Employees.js --kind nodejs:8

Important: When you create or update an Action, always specify the kind nodejs:8. If the kind is not explicitly provided, the action uses the default nodejs:6 version.

3. Bind the IBM Cloud service to your function to set the ssldsn as a default parameter.

bx wsk service bind dashDB Employees

For more information about the new service bind for IBM Cloud Functions, see the following blog post.

If you don’t yet have the service created in your Namespace, use the following command to create the service instance.

bx service create dashDB Entry db2

4. Invoke the Action from the CLI for testing, and retrieve the results:

   
bx wsk action invoke Employees -r
  {
    "employees": [
      {
        "EMAIL": "DPage@grtd123.com",
        "FIRST_NAME": "Denis",
        "LAST_NAME": "Pagé"
      },
      {
        "EMAIL": "EMichel@grtd123.com",
        "FIRST_NAME": "Élizabeth",
        "LAST_NAME": "Michel"
      },
      {
        "EMAIL": "EClermont@grtd123.com",
        "FIRST_NAME": "Émile",
        "LAST_NAME": "Clermont"
      }
    ]
  }

 

Get started with IBM Cloud Functions with your Free account.

Senior Technical Staff Member (STSM) - IBM Cloud Functions

More What's New stories

Movius teams with IBM Cloud to disrupt the telecom market

“With our mobile cloud solution, we are doing for phones what Windows did for the PC.” Anath Siva, Chief Customer Officer, Movius

Continue reading

Announcing IBM Key Protect Release in Frankfurt EU Region on IBM Public Cloud

Data leakage associated with data stored in the cloud is one of the top security concerns of cloud computing users. Having the ability to protect data with cryptographic encryption key management is critical to the overall security of a cloud ecosystem. Company policies, industry best practices, and government regulations are increasingly requiring data-at-rest encryption supported by encryption key management to be included as fundamental components of overall data storage, data management, and data governance.

Continue reading

IBM Cloud announces network expansion with availability zones in six global regions

Learn about our plans to launch 18 availability zones for IBM Cloud in six major regions in North America (Dallas, Texas and Washington, DC), Europe (Germany and UK) and Asia-Pacific (Tokyo and Sydney). You'll also discover our new approach to deliver our full stack of public cloud capabilities in a more highly available, redundant, and geographically dispersed manner.

Continue reading