npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

eslint-plugin-no-implicit-side-effects

v1.0.0

Published

ESLint plugin for requiring side effects to be explicit.

Downloads

19

Readme

No Implicit Side Effects Plugin for ESLint

Build Status Coverage Status

An ESLint plugin to help writing JS in a pure functional style. Forces programmers to be only introduce (own) side effects knowingly by prefixing them with void, making side effects explicit and thus easy to find.

Why void?

In C-like languages, void is most commonly used to denote a function without a return value, so by definition a side effect. In JavaScript, void is used to make any expression have the value undefined, as in no value. An expression that doesn't result in any value is also by definition a side effect. Considering these, I think void is the perfect keyword for this, especially because prefixing an expression whose value is not used with void doesn't change the program's behavior in any way.

Installation

npm install --save-dev eslint-plugin-no-implicit-side-effects

NOTE: This plugin requires node v4.0 or higher.

Then add to the list of plugins in .eslintrc:

"plugins": ["no-implicit-side-effects"]

Instructions for setting up individual rules can be found the rules section.

Rules

no-implicit-side-effects

Config:

"no-implicit-side-effects/no-implicit-side-effects": 2

Description

Requires making your side effects explicit. This means that you cannot have statements that only contain an expression, e.g.

// Not OK:
a = 1;
b.c = 2;
foo();
bar.qoo();
z.y++;
[1, 2, 3].forEach(n => console.log(n));
(function (){}());
// etc...

instead your functions should be focused on what is being returned. Expressions within a return statement or variable declarations are considered valid. If side effects such as assignment or function calls with unused return value are required, prefix them with void to make them explicit:

// OK:
void (a = 1);
void (b.c = 2);
void foo();
void bar.qoo();
void z.y++;
void [1, 2, 3].forEach(n => console.log(n));
void function (){}();

// also OK:
var h = 3;
let i = 4;
const j = 5;
return foo();

Pitfalls

External side effects

This rule does not prevent indirect side effects. For example if function foo has a side effect and you declare function bar as:

function bar (v) {
    return foo(v + 1);
}

the rule will not complain because the violation is not actually in this function.

Arrow functions

Single expression arrow functions can mask a side effect because they appear as a return value. For example return promise.then(v => console.log(v)); will not be caught.

Unary increment/decrement

Unary increment and decrement are always side effects, but this rule doesn't have special treatment for them, which means side effects like this would be considered valid: var x = y++;. You can however use the built-in rule no-plus-plus for catching these.

Recommended built-in rules

These will make it easier to develop in a pure functional style:

  • no-class-assign.
  • no-cond-assign
  • no-const-assign.
  • no-func-assign.
  • no-new.
  • no-param-reassign.
  • no-plusplus.
  • no-return-assign.
  • no-sequences.
  • no-var.
  • operator-assignment ("never").
  • prefer-arrow-callback.
  • prefer-const.