function-caller

function-caller is a cross-component function call library written in Typescript

Installing

Package manager

Using npm:

npm install function-caller

Using yarn:

$ yarn add function-caller

Once the package is installed, you can import the library using import or require approach:

import FunctionCaller, {set, call} from 'function-caller';

If you use require for importing, only default export is available:

const FunctionCaller = require('function-caller');

CDN

Using unpkg CDN:

<script src="https://unpkg.com/function-caller/dist/index.min.js"></script>

Example

Basic example

// create a function
const myFunc = function (a, b) {
    return a + b;
}

// register a function with the function-caller
const myKey = 'myKey';
FunctionCaller.set(myKey, myFunc);

// call a function using the function-caller
const callReturn = FunctionCaller.call(myKey, 2, 3);
console.log(callReturn); // 5

// call a function asynchronously using the function-caller
FunctionCaller.asyncCall(myKey, 4, 6).then((value) => {
    console.log(value); // 10
}); 

Unregister function

// create a function
const myFunc = function (a, b) {
    return a + b;
}

// register a function with the function-caller
const myKey = 'myKey';
FunctionCaller.set(myKey, myFunc);

// unregister in function-caller
FunctionCaller.remove(myKey);

Clear all registration

FunctionCaller.set('key1', ()=>{});
FunctionCaller.set('key2', ()=>{});
FunctionCaller.set('key3', ()=>{});

FunctionCaller.clear();
// all registration are removed

Working with React

Register function in component A

import React, { useState, useEffect } from 'react'
// import function-caller library
import FunctionCaller from 'function-caller'

// export registration key
export const SET_TEXT = "set text";

export default function A() {
  // create a function
  const [text, setText] = useState('Hi');

  useEffect(() => {
    // register function when the component did mount
    FunctionCaller.set(SET_TEXT, setText);
    return () => {
      // unregister function when component will unmount
      FunctionCaller.remove(SET_TEXT);
    }
  }, [])

  return (
    <div>
      A Component
      <span>{text}</span>
    </div>
  )
}

Call function in component B

import React from 'react'
// import function-caller library
import FunctionCaller from 'function-caller'

// import registration key
import { SET_TEXT } from '../A';

export default function B() {
  const onChange = (event) => {
    const { target } = event;
    const newText = target.value;
    // call the function using the function-caller
    FunctionCaller.call(SET_TEXT, newText);
  }
  return (
    <div>
      B Component
      <input onChange={onChange}/>
    </div>
  )
}

function-caller API

function	return
set(key: string, func: Function)	boolean
call(key: string, ...args: any[])	any
asyncCall(key: string, ...args: any[])	Promise<any>
remove(key: string)	void
clear()	void
hasKey(key: string)	boolean
getKeys()	IterableIterator<string>
getEntries()	IterableIterator<[string, Function]>
getFunction(key: string)	Function | undefined
getSize()	number

License

MIT