@availentdev/suitemocks NPM

README

What is this repository for?

This contains mocks of SuiteScript entry points for use with jest testing.
Version 0.1.2

How do I get set up?

You can install by running npm install @availentdev/suitemocks
Before using this package
- Follow instructions for setting up your SuiteScript project for testing here
- Additional information can be found here
- Test examples can be found here
Once installed and your project is configured for testing
- Copy and paste the following over the contents of jest.config.js
- This adds the array of custom stubs, which allows custom stubs to mimic the import style of stubs provided by @oracle/suitecloud-unit-testing
  - Ex. import afterSubmitContext from 'N/ScriptContext/afterSubmitContext';
  - Rather than ./path/to/file/afterSubmitContext
- The transformIgnorePatterns property is modified to include this package so that @babel can transform them properly alongside the stubs provided by @oracle/suitecloud-unit-testing

const SuiteCloudJestConfiguration = require('@oracle/suitecloud-unit-testing/jest-configuration/SuiteCloudJestConfiguration');
const cliConfig = require('./suitecloud.config');

const TESTING_FRAMEWORK_PATH = '@oracle/suitecloud-unit-testing';
const CORE_STUBS_PATH = `${TESTING_FRAMEWORK_PATH}/stubs`;
const nodeModulesToTransform = [CORE_STUBS_PATH].join('|');

const build = SuiteCloudJestConfiguration.build({
  projectFolder: cliConfig.defaultProjectFolder,
  projectType: SuiteCloudJestConfiguration.ProjectType.ACP,
  customStubs: [
    {
      module: 'N/ScriptContext/beforeLoadContext',
      path: '<rootDir>/node_modules/@availentdev/suitemocks/customStubs/UserEvent/beforeLoadContext.js',
    },
    {
      module: 'N/ScriptContext/beforeSubmitContext',
      path: '<rootDir>/node_modules/@availentdev/suitemocks/customStubs/UserEvent/beforeSubmitContext.js',
    },
    {
      module: 'N/ScriptContext/afterSubmitContext',
      path: '<rootDir>/node_modules/@availentdev/suitemocks/customStubs/UserEvent/afterSubmitContext.js',
    },
    {
      module: 'N/ScriptContext/inputContext',
      path: '<rootDir>/node_modules/@availentdev/suitemocks/customStubs/MapReduce/inputContext.js',
    },
    {
      module: 'N/ScriptContext/mapContext',
      path: '<rootDir>/node_modules/@availentdev/suitemocks/customStubs/MapReduce/mapContext.js',
    },
    {
      module: 'N/ScriptContext/reduceContext',
      path: '<rootDir>/node_modules/@availentdev/suitemocks/customStubs/MapReduce/reduceContext.js',
    },
    {
      module: 'N/ScriptContext/summaryContext',
      path: '<rootDir>/node_modules/@availentdev/suitemocks/customStubs/MapReduce/summaryContext.js',
    },
    {
      module: 'N/ScriptContext/pageInitContext',
      path: '<rootDir>/node_modules/@availentdev/suitemocks/customStubs/ClientScript/pageInitContext.js',
    },
    {
      module: 'N/ScriptContext/saveRecordContext',
      path: '<rootDir>/node_modules/@availentdev/suitemocks/customStubs/ClientScript/saveRecordContext.js',
    },
    {
      module: 'N/ScriptContext/fieldChangedContext',
      path: '<rootDir>/node_modules/@availentdev/suitemocks/customStubs/ClientScript/fieldChangedContext.js',
    },
  ],
});

build.transformIgnorePatterns = [`/node_modules/(?!(${nodeModulesToTransform}|@availentdev/suitemocks)/)`];

module.exports = build;

Each scriptContext mock contains the properties normally found in the scriptContext for that entry point

Properties representing SuiteScript module objects are included with each of their methods as a jest function
Properties of primitive data types default to undefined
Enums are included

Example for User Event afterSubmit:

{
 oldRecord = recordObj,
 newRecord = recordObj,
 type = undefined,
 UserEventType = {
   COPY: 'copy',
   CREATE: 'create',
   VIEW: 'view',
   EDIT: 'edit',
   XEDIT: 'xedit',
   DELETE: 'delete',
   DROPSHIP: 'dropship',
   SPECIALORDER: 'specialorder',
   ORDERITEMS: 'orderitems',
   CANCEL: 'cancel',
   APPROVE: 'approve',
   REJECT: 'reject',
   RETRACT: 'retract',
   SAVESUBMIT: 'savesubmit',
   PACK: 'pack',
   SHIP: 'ship',
   EDITFORECAST: 'editforecast',
   REASSIGN: 'reassign',
   MARKCOMPLETE: 'markcomplete',
   PRINT: 'print',
   EMAIL: 'email',
   CHANGEPASSWORD: 'changepassword',
   TRANSFORM: 'transform',
   PAYBILLS: 'paybills',
   QUICKVIEW: 'quickview',
 }
}

* oldRecord and newRecord in this example represent record.record objects
  * Each method is a jest function
    * Immediately available in tests `expect(afterSubmitScriptContextMock.getValue).toHaveBeenCalled();`
    * However, any mock returns or implementations need to be set up in the test file

Contribution guidelines

To create new script contexts, copy an existing context file that most closely matches the one you need. Then, using NetSuite's documentation, add, remove, or modify the properties.

Entry points not yet included: Bundle Installation Script: