# trim-call

> Drops undefined arguments from the end of a function call.

Latest version **1.1.0** (published 2019-10-12) · MIT license · 0 weekly downloads

## Install

```sh
npm install trim-call
pnpm add trim-call
yarn add trim-call
bun add trim-call
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.1.0 |
| Published | 2019-10-12 |
| First published | 2018-01-21 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=6.0.0 |
| Dependencies | 1 |
| Unpacked size | 4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | Fr. John Lamansky |
| Maintainers | lamansky |
| Keywords | trim, undefined, arguments, function, call |

## Links

- npm: https://www.npmjs.com/package/trim-call
- Repository: https://github.com/lamansky/trim-call
- Issues: https://github.com/lamansky/trim-call/issues
- npm.io page: https://npm.io/package/trim-call

## Dependencies (1)

- [rtrim-array](https://npm.io/package/rtrim-array.md) ^1.0.0

## Recent versions

- 1.1.0 (latest) — 2019-10-12
- 1.0.0 — 2018-01-21

## README

# trim-call

Drops undefined arguments from the end of a function call.

Useful if you’re forwarding arguments from one function to another, but the second function has behavior which is affected by the presence of an explicit `undefined` argument.

Accepts an arguments list, just like [`Function.prototype.call()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function/call). If you want to provide an argument array instead, use the [`trim-apply`](https://github.com/lamansky/trim-apply) module.

## Installation

Requires [Node.js](https://nodejs.org/) 6.0.0 or above.

```bash
npm i trim-call
```

## API

The module exports a function (`trimCall()`) that has one other function attached to it as a method (`trimCall.new()`).

### `trimCall()`

#### Parameters

1. `fn` (function): The function to call.
2. `thisArg` (any): The value of `this` while the function is being called.
3. Variadic: `...args` (one or more of: any): The arguments for the function call. Any `undefined` arguments at the end will be dropped.

#### Return Value

The return value of `fn` when called with `thisArg` and `args`.

### `trimCall.new()`

#### Parameters

1. `Cls` (class): The class whose constructor you want to call.
2. Variadic: `...args` (one or more of: any): The arguments for the constructor call. Any `undefined` arguments at the end will be dropped.

#### Return Value

A new instance of `Cls` constructed with `args`.

## Examples

```javascript
const trimCall = require('trim-call')

f1('test')

function f1 (a, b) {
  trimCall(f2, this, a, b)
}

function f2 () {
  arguments.length // 1
}
```

Because of `trimCall()`, the `f2()` function only receives one argument.

Here is the above example repeated _without_ `trimCall()`:

```javascript
f1('test')

function f1 (a, b) {
  f2.call(this, a, b)
}

function f2 () {
  arguments.length // 2
}
```

Without `trimCall()`, the undefined `b` argument of `f1()` becomes an explicit second argument for `f2()`.

## Related

* [trim-apply](https://github.com/lamansky/trim-apply)

---
_Source: https://npm.io/package/trim-call · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._