Getting started

The API for Mutate is similar in a lot of ways to the API of jQuery with a significant difference, that is selectors (Collectors) refer to all current and future matching Elements, and the functions to modify the DOM (Mutations) are persistent.

This means that you don't need to worry about timing, or dynamic areas of the rendered page.

Installation

Mutate comes bundled with the Evolv AI Asset Manager, so if you're writing an experiment using the Evolv AI platform you do not need to install separately. For bundling Mutate with a Node project, follow the instructions below.

$ npm install @evolv/mutate

Importing

import { collect, mutate } from '@evolv/mutate';

Building from source

If you have access clone it from the Mutate repo.

Setup

$ npm install

Scripts

Script	Description
npm run build	Build Mutate
npm start	Build Mutate and host on http://localhost:8080
npm run demo	Run demo website. Content warning: flashing lights

Basic Usage

The basic flow when using Mutate is to first define a Collector.

collect('<selector>', '<collector name>');

Then to define a Mutator for the Collector.

mutate('<collector name>').hide();

Mutators allow for Mutations to be chained together, similarly to jQuery which will be evaluated in order of invocation.

mutate('<collector name>').text('<new text value>').classes({'<new class>': true});