Sidekick is a tool written in Node.js for processing .side
files. It is designed to work with Selenium IDE projects, allowing you to filter and export your test suites into New Relic Scripted Browser compatible files.
You can find this package on npm: newrelic-sidekick
You can install Sidekick globally using npm:
npm install -g newrelic-sidekick
To use Sidekick, you need to provide an input .side
file and an output directory:
sidekick <input.side> <output_directory>
For example:
sidekick myProject.side ./output
This will process the myProject.side
file and output the results to the ./output
directory.
This guide details the automated test step types generated by SideKick
. The steps are automatically generated and can be amended only in the output script itself ( *.js
file). It's important to understand the behavior of each step type to make appropriate adjustments in the script for accurate test execution and results.
By default all steps are generated as HARD
steps. The step type can be changed by using the stepLogger
function. The function accepts the following parameters:
stepType
- the type of the step. See below for the list of available step types.stepName
- the name of the step. This is the name that will be displayed in the script's log output.journeyName
- the name of the journey. This is the name that will be displayed in the script's log output.stepFunction
- the function that implements the step. This is the function that will be executed when the step is executed.
Those parameters are generated automatically by SideKick
and can be adjusted in the output script.
- Definition: Critical steps whose failure stops the test journey.
- Behavior: Execution halts on failure.
- Use Case: Essential functionalities.
- Example:
await stepLogger( STEP_TYPE.HARD, // step type "Open URL", // step name "Journey", // journey name async () => { /* step implementation */ } );
- Definition: Important but not critical steps. Test continues on failure, but it's recorded.
- Behavior: Test journey continues; failure marks journey as failed.
- Use Case: Important but non-critical functionalities.
- Example:
await stepLogger( STEP_TYPE.SOFT, // step type // ... other parameters );
- Definition: Steps that do not impact the test outcome.
- Behavior: Failure is noted but doesn't affect overall success.
- Use Case: Non-essential features.
- Example:
await stepLogger( STEP_TYPE.OPTIONAL, // step type // ... other parameters );
New Relic hosts and moderates an online forum where customers can interact with New Relic employees as well as other customers to get help and share best practices.
We encourage your contributions to improve newrelic-sidekick! Keep in mind when you submit your pull request, you'll need to sign the CLA via the click-through using CLA-Assistant. You only have to sign the CLA one time per project. If you have any questions, or to execute our corporate CLA, required if your contribution is on behalf of a company, please drop us an email at [email protected].
A note about vulnerabilities
As noted in our security policy, New Relic is committed to the privacy and security of our customers and their data. We believe that providing coordinated disclosure by security researchers and engaging with the security community are important means to achieve our security goals.
If you believe you have found a security vulnerability in this project or any of New Relic's products or websites, we welcome and greatly appreciate you reporting it to New Relic through HackerOne.
New Relic SideKick is licensed under the Apache 2.0 License.