No description, website, or topics provided.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Squarespace Darwin

Passthrough implementation of MutationObserver designed to make it easier to use, handling DOM querying, browser compatibility, and other stuff like that for you.

NOTICE: This code is licensed to you pursuant to Squarespace’s Developer Terms of Use. See license section below.


npm install @squarespace/darwin;
import Darwin from '@squarespace/darwin';

const instance = new Darwin({
  callback: () => {
    console.log('Mutation observed!');
  targets: [

Using ES6

If you prefer to handle transpiling and polyfilling on your own, you can import ES6 from Darwin:

import darwin from '@squarespace/darwin/src';

Alternately, Darwin specifies a module property in package.json that points to the uncompiled src/index.js, so you may be able to simply import @squarespace/darwin if you're using one of the following bundlers:


new Darwin(config)


  • config Object - Config object
  • config.callback Array - Callback function to run when mutations occur
  • config.targets Boolean - Selectors of targets to observe


Create a new MutationObserver and instruct it to observe the targets you gave it.


Unbind all event listeners, disconnect the MutationObserver and null it out.


Portions Copyright © 2016 Squarespace, Inc. This code is licensed to you pursuant to Squarespace’s Developer Terms of Use, available at (the “Developer Terms”). You may only use this code on websites hosted by Squarespace, and in compliance with the Developer Terms. TO THE FULLEST EXTENT PERMITTED BY LAW, SQUARESPACE PROVIDES ITS CODE TO YOU ON AN “AS IS” BASIS WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED.