npmpackage.info

Gathering detailed insights and metrics for react-clientside-effect

react-clientside-effect - 1.2.7 | npmpackage.info

react-clientside-effect

Create components whose nested prop changes map to a global side effect

1.2.7

MIT

JavaScript

786.00 B

471,753,014 2.1

Installations

npm install react-clientside-effect

Developer Guide

BETA

Typescript

No

Module System

CommonJS

Node Version

16.20.2

NPM Version

8.19.4 Score

96.9

Supply Chain

100

Quality

76.7

Maintenance

100

Vulnerability

100

License

Pull Requests

Open

0

Total

7

Closed

0

Merged

7

Issues

Open

0

Total

0

Closed

0

Releases

Unable to fetch releases

Languages

JavaScript

JavaScript (100%)

Developer

thekashey

Download Statistics

Total Downloads

471,753,014

Last Day

363,579

Last Week

1,897,136

Last Month

8,058,940

Last Year

91,654,334

GitHub Statistics

MIT License

100 Commits

4 Forks

2 Watchers

3 Branches

1 Contributors

Updated on Dec 15, 2024

Bundle Size

1.63 kB

Minified

786.00 B

Minified + Gzipped

Bundlephobia

Maintainers

View All 1 Contributors

Package Meta Information

Latest Version

1.2.7

Package Id

react-clientside-effect@1.2.7

Unpacked Size

16.28 kB

Size

4.73 kB

File Count

NPM Version

8.19.4

Node Version

16.20.2

Published on

Dec 15, 2024

Total Downloads

Cumulative downloads

Total Downloads

471,753,014

Last Day

44.1%

363,579

Compared to previous day

Last Week

3.9%

1,897,136

Compared to previous week

Last Month

-5.3%

8,058,940

Compared to previous month

Last Year

2.7%

91,654,334

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

React Side Effect

Create components whose prop changes map to a global side effect.

This is client-side variation of the original react-side-effect, for client-side components. It does nothing on server side.

Installation

npm install --save react-clientside-effect

Use Cases

Setting document.body.style.margin or background color depending on current screen;
Firing Flux actions using declarative API depending on current screen;
Some crazy stuff I haven't thought about.

How's That Different from `componentDidUpdate`?

It gathers current props across the whole tree before passing them to side effect. For example, this allows you to create <BodyStyle style> component like this:

1// RootComponent.js
2return (
3  <BodyStyle style={{ backgroundColor: 'red' }}>
4    {this.state.something ? <SomeComponent /> : <OtherComponent />}
5  </BodyStyle>
6);
7
8// SomeComponent.js
9return (
10  <BodyStyle style={{ backgroundColor: this.state.color }}>
11    <div>Choose color: <input valueLink={this.linkState('color')} /></div>
12  </BodyStyle>
13);

and let the effect handler merge style from different level of nesting with innermost winning:

1import { Component, Children } from 'react';
2import PropTypes from 'prop-types';
3import withSideEffect from 'react-side-effect';
4
5class BodyStyle extends Component {
6  render() {
7    return Children.only(this.props.children);
8  }
9}
10
11BodyStyle.propTypes = {
12  style: PropTypes.object.isRequired
13};
14
15function reducePropsToState(propsList) {
16  var style = {};
17  propsList.forEach(function (props) {
18    Object.assign(style, props.style);
19  });
20  return style;
21}
22
23function handleStateChangeOnClient(style) {
24  Object.assign(document.body.style, style);
25}
26
27export default withSideEffect(
28  reducePropsToState,
29  handleStateChangeOnClient
30)(BodyStyle);

API

`withSideEffect: (reducePropsToState, handleStateChangeOnClient, [mapStateOnServer]) -> ReactComponent -> ReactComponent`

A higher-order component that, when mounting, unmounting or receiving new props, calls reducePropsToState with props of each mounted instance. It is up to you to return some state aggregated from these props.

On the client, every time the returned component is (un)mounted or its props change, reducePropsToState will be called, and the recalculated state will be passed to handleStateChangeOnClient where you may use it to trigger a side effect.

Usage

Here's how to implement React Document Title (both client and server side) using React Side Effect:

1import React, { Children, Component } from 'react';
2import PropTypes from 'prop-types';
3import withSideEffect from 'react-side-effect';
4
5class DocumentTitle extends Component {
6  render() {
7    if (this.props.children) {
8      return Children.only(this.props.children);
9    } else {
10      return null;
11    }
12  }
13}
14
15DocumentTitle.propTypes = {
16  title: PropTypes.string.isRequired
17};
18
19function reducePropsToState(propsList) {
20  var innermostProps = propsList[propsList.length - 1];
21  if (innermostProps) {
22    return innermostProps.title;
23  }
24}
25
26function handleStateChangeOnClient(title) {
27  document.title = title || '';
28}
29
30export default withSideEffect(
31  reducePropsToState,
32  handleStateChangeOnClient
33)(DocumentTitle);

No vulnerabilities found.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

License

Determines if the project has defined a license.

3

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Maintained

Determines if the project is "actively maintained".

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Fuzzing

Determines if the project uses fuzzing.

0

Security-Policy

Determines if the project has published a security policy.

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

0

SAST

Determines if the project uses static code analysis.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Reason

60 existing vulnerabilities detected

Details

Warn: Project is vulnerable to: GHSA-968p-4wvh-cqc8
Warn: Project is vulnerable to: GHSA-67hx-6x53-jw92
Warn: Project is vulnerable to: GHSA-6chw-6frg-f759
Warn: Project is vulnerable to: GHSA-v88g-cgmw-v5xw
Warn: Project is vulnerable to: GHSA-832h-xg76-4gv6
Warn: Project is vulnerable to: GHSA-cwfw-4gq5-mrqx
Warn: Project is vulnerable to: GHSA-g95f-p29q-9xw4
Warn: Project is vulnerable to: GHSA-grv7-fg5c-xmjg
Warn: Project is vulnerable to: GHSA-w8qv-6jwh-64r5
Warn: Project is vulnerable to: GHSA-p28h-cc7q-c4fg
Warn: Project is vulnerable to: GHSA-9vvw-cc9w-f27h
Warn: Project is vulnerable to: GHSA-gxpj-cx7g-858c
Warn: Project is vulnerable to: GHSA-w573-4hg7-7wgq
Warn: Project is vulnerable to: GHSA-h6ch-v84p-w6p9
Warn: Project is vulnerable to: GHSA-ww39-953v-wcq6
Warn: Project is vulnerable to: GHSA-qh2h-chj9-jffq
Warn: Project is vulnerable to: GHSA-q42p-pg8m-cqh6
Warn: Project is vulnerable to: GHSA-w457-6q6x-cgp9
Warn: Project is vulnerable to: GHSA-62gr-4qp9-h98f
Warn: Project is vulnerable to: GHSA-f52g-6jhx-586p
Warn: Project is vulnerable to: GHSA-2cf5-4w76-r9qv
Warn: Project is vulnerable to: GHSA-3cqr-58rm-57f8
Warn: Project is vulnerable to: GHSA-g9r4-xpmj-mj65
Warn: Project is vulnerable to: GHSA-q2c6-c6pm-g3gh
Warn: Project is vulnerable to: GHSA-765h-qjxv-5f44
Warn: Project is vulnerable to: GHSA-f2jv-r9rf-7988
Warn: Project is vulnerable to: GHSA-2pr6-76vf-7546
Warn: Project is vulnerable to: GHSA-8j8c-7jfh-h6hx
Warn: Project is vulnerable to: GHSA-896r-f27r-55mw
Warn: Project is vulnerable to: GHSA-9c47-m6qq-7p4h
Warn: Project is vulnerable to: GHSA-6c8f-qphg-qjgp
Warn: Project is vulnerable to: GHSA-29mw-wpgm-hmr9
Warn: Project is vulnerable to: GHSA-35jh-r3h4-6jhm
Warn: Project is vulnerable to: GHSA-2m96-9w4j-wgv7
Warn: Project is vulnerable to: GHSA-h726-x36v-rx45
Warn: Project is vulnerable to: GHSA-p6mc-m468-83gw
Warn: Project is vulnerable to: GHSA-952p-6rrq-rcjv
Warn: Project is vulnerable to: GHSA-f8q6-p94x-37v3
Warn: Project is vulnerable to: GHSA-vh95-rmgr-6w4m
Warn: Project is vulnerable to: GHSA-xvch-5gv4-984h
Warn: Project is vulnerable to: GHSA-fhjf-83wg-r2j9
Warn: Project is vulnerable to: GHSA-w9mr-4mfr-499f
Warn: Project is vulnerable to: GHSA-r683-j2x4-v87g
Warn: Project is vulnerable to: GHSA-rp65-9cf3-cjxr
Warn: Project is vulnerable to: GHSA-hj48-42vr-x3v9
Warn: Project is vulnerable to: GHSA-hrpp-h998-j3pp
Warn: Project is vulnerable to: GHSA-6g33-f262-xjp4
Warn: Project is vulnerable to: GHSA-p8p7-x288-28g6
Warn: Project is vulnerable to: GHSA-gcx4-mw62-g8wm
Warn: Project is vulnerable to: GHSA-c2qf-rxjj-qqgw
Warn: Project is vulnerable to: GHSA-4g88-fppr-53pp
Warn: Project is vulnerable to: GHSA-4jqc-8m5r-9rpr
Warn: Project is vulnerable to: GHSA-2m39-62fm-q8r3
Warn: Project is vulnerable to: GHSA-72xf-g2v4-qvf3
Warn: Project is vulnerable to: GHSA-662x-fhqg-9p8v
Warn: Project is vulnerable to: GHSA-394c-5j6w-4xmx
Warn: Project is vulnerable to: GHSA-fhg7-m89q-25r3
Warn: Project is vulnerable to: GHSA-cf4h-3jhx-xvhq
Warn: Project is vulnerable to: GHSA-6fc8-4gx4-v693
Warn: Project is vulnerable to: GHSA-3h5v-q93c-6h6q

Score

2.1

/10

Last Scanned on 2025-04-28

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More

react-clientside-effect

Installations

Developer Guide

No

CommonJS

16.20.2

8.19.4

Score

Pull Requests

0

7

0

7

Issues

0

0

0

Releases

Unable to fetch releases

Languages

Developer

thekashey

Download Statistics

GitHub Statistics

Bundle Size

1.63 kB

786.00 B

Maintainers

Package Meta Information

Total Downloads

471,753,014

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

Peer Dependencies

Dev Dependencies

React Side Effect

Installation

Use Cases

How's That Different from componentDidUpdate?

API

withSideEffect: (reducePropsToState, handleStateChangeOnClient, [mapStateOnServer]) -> ReactComponent -> ReactComponent

Usage

10

10

3

0

0

0

0

0

0

0

2.1

/10

How's That Different from `componentDidUpdate`?

`withSideEffect: (reducePropsToState, handleStateChangeOnClient, [mapStateOnServer]) -> ReactComponent -> ReactComponent`