Example of custom helper to perform conditional click (without throwing an error)

codecept.conf.js

const outputFolder = './output';

exports.config = {
  output: outputFolder,
  helpers: {
    Puppeteer: {
      url: 'http://google.com',
      show: true,
      chrome: {}
    },
    Mochawesome: {
      uniqueScreenshotNames: true,
    },
    customHelper: {
      require: '../helpers/customHelper.js',
    },
  },
  include: {},
  mocha: {},
  bootstrap: false,
  teardown: null,
  hooks: [],
  tests: '../tests_puppeteer/*_test.js',
  timeout: 10000,
  name: 'doler-js',
};

customHelper.js

'use strict';
import assert from 'assert';

let Helper = codecept_helper;

class MyHelper extends Helper {
  async clickIfVisible(selector, ...options) {
    const helper = this.helpers['Puppeteer'];
    try {
      const numVisible = await helper.grabNumberOfVisibleElements(selector);

      if (numVisible) {
        return helper.click(selector, ...options);
      }
    } catch (err) {
      console.log('Skipping operation as element is not visible');
    }
  }
}

module.exports = MyHelper;

example_test.js

Feature('Example')

Scenario('Example of conditional click', (I) => {
    I.amOnPage('https://google.com');
    I.clickIfVisible('.SomethingThatDoesNotExist'); // Function is declared in MyCustomHelper.js
});