Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

@tractor/plugin-loader

Package Overview
Dependencies
Maintainers
7
Versions
54
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@tractor/plugin-loader

File structure handler for tractor

  • 1.9.4-tractor-to-playwright.0
  • latest
  • Source
  • npm
  • Socket score

Version published
Maintainers
7
Created
Source

@tractor/plugin-loader

Plugin loader for tractor to provide additional UI testing capabilities.

npm version

API

loadPlugins (config: TractorPluginConfig): Array<TractorPlugin>

Loads all available tractor plugins for a project.

import { loadConfig } from '@tractor/config-loader';
import { loadPlugins } from '@tractor/plugin-loader';

const config = loadConfig(process.cwd(), './path/to/tractor.conf.js');
const plugins = loadPlugins(config);

getPlugins (): Array<TractorPlugin

Retrieves the current plugins for the running Tractor instance. loadPlugins() must be called befere calling getPlugins().

import { getPlugins } from '@tractor/plugin-loader';

const plugins = getPlugins();

How it works

Whenever tractor is run, the loader looks through your installed node modules, and finds any that are called @tractor-plugin/whatever. Those plugins could provide new actions for tests, new testing styles, or entirely new bits of UI/Functionality for the @tractor/ui application, all depending on what the plugin exports.

Plugin

A tractor plugin is just a plain old node module, with a few specially named exports, and maybe some bundled UI code. If you want to see an example of a basic plugin, check out tractor-plugin-browser. A plugin looks something like this:

import { Config } from 'protractor';

export type TractorPlugin<T> = {
    description: {
        actions: Array<TractorAction>
    };

    create (): T;
    init (): Promise<void> | void;
    plugin (protractorConfig: Config): Config;
    run (): Promise<void> | void;
    serve (): Promise<void> | void;
    upgrade (): Promise<void> | void;
};

description (optional)

The description of the plugin object. Check out the type signature in more details here.

create (optional)

Defines how an instance of the plugin will be instantiated when Protractor runs. It should return a concrete implementation of each of the description.

init (optional)

Initialise anything that the plugin needs before it runs. This may be things like creating directories or getting information about the current environment, before tractor starts running.

plugin (optional)

Modify the portractorConfig before Protractor runs. This is where the plugin should set up any Protractor plugins that it needs. To see an example of how this works, check out @tractor-plugin/mocha-specs.

run (optional)

Run any extra code the need before the app server starts. At the point that this is called all other plugins have been initialised and served.

serve (optional)

Define any new endpoints that the plugin needs to attach to the @tractor/server, typically for consuming from the @tractor/ui.

UI Script (optional)

A plugin can also contain UI code. The loader looks for a file at @tractor-plugin/my-plugin/dist/client/bundle.js and injects that into the @tractor/ui when it is served. It is run before the bootstrapping of the Angular application, so it can set-up routes etc. To see an example of how this works, check out @tractor-plugin/visual-regression.

FAQs

Package last updated on 10 Aug 2021

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc