# pino-caller

> print the filename and line number of the caller (use only in development environment)

Latest version **4.0.0** (published 2025-04-16) · MIT license · 0 weekly downloads

## Install

```sh
npm install pino-caller
pnpm add pino-caller
yarn add pino-caller
bun add pino-caller
```

## Health

**Score 45/100 (D)** — status: stable.

Positive: has types; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support.

Negative: stale.

## Facts

| | |
|---|---|
| Version | 4.0.0 |
| Published | 2025-04-16 |
| First published | 2017-03-06 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Node | >6.0.0 |
| Dependencies | 1 |
| Unpacked size | 17.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 72 |
| Author | phra |
| Maintainers | matteo.collina, jsumners, watson, davidmarkclements, phra |

## Links

- npm: https://www.npmjs.com/package/pino-caller
- Repository: https://github.com/pinojs/pino-caller
- Homepage: https://github.com/pinojs/pino-caller#readme
- Issues: https://github.com/pinojs/pino-caller/issues
- npm.io page: https://npm.io/package/pino-caller

## Dependencies (1)

- [source-map-support](https://npm.io/package/source-map-support.md) ^0.5.13

## Recent versions

- 4.0.0 (latest) — 2025-04-16
- 3.4.0 — 2023-02-21
- 3.3.0 — 2022-12-27
- 3.2.0 — 2021-10-05
- 3.1.0 — 2021-03-08
- 3.0.2 — 2020-05-04
- 3.0.1 — 2020-02-12
- 3.0.0 — 2018-08-08
- 2.0.1 — 2018-06-06
- 2.0.0 — 2017-05-25
- 1.0.1 — 2017-03-09
- 1.0.0 — 2017-03-06

## README

## pino-caller
[![npm version](https://img.shields.io/npm/v/pino-caller)](https://www.npmjs.com/package/pino-caller)
[![Build Status](https://img.shields.io/github/actions/workflow/status/pinojs/pino-caller/ci.yml?branch=master)](https://github.com/pinojs/pino-caller/actions)
[![Coverage Status](https://coveralls.io/repos/github/pinojs/pino-caller/badge.svg?branch=master)](https://coveralls.io/github/pinojs/pino-caller?branch=master)
[![js-standard-style](https://img.shields.io/badge/code%20style-standard-brightgreen.svg?style=flat)](https://standardjs.com/)

### Description
`pino-caller` is a wrapper for [pino](https://github.com/pinojs/pino) which adds the call site of each log message to the log output.
This can be useful when developing with large codebases in order to locate the exact point where pino is invoked.

### Install

For Pino v4 and below use the v2 line, which can be installed with the `@legacy` tag:

```sh
npm install pino-caller@legacy
``` 

For Pino v5 and above use the v3+ line, which will install using the usual command:

```
npm install pino-caller
```

**WARNING: THIS IS A DEVELOPMENT TOOL AVOID PRODUCTION USE!**

### Usage

#### Basic
```js
'use strict'

const pino = require('pino')() // it will print as usual
const pinoCaller = require('pino-caller')(pino) // it will print also the calling site

pinoCaller.info('info1')
pinoCaller.error('error1')
pinoCaller.debug('debug1')
```

#### Advanced
```js
'use strict'
// dynamically load the plugin if in development environment, output paths relative to __dirname
const pino = process.env.NODE_ENV === 'development' ? require('pino-caller')(require('pino')(), { relativeTo: __dirname }) : require('pino')()

pino.info('info1')
pino.error('error1')
pino.debug('debug1')
```

You can find also a working example in the `examples` directory and you can run it with `npm run example`

##### Options

- **relativeTo** - Remove path prefixes from log messages to make them easier to read.
- **stackAdjustment** - For those who've wrapped pino, make pino-caller move N stackframes up to get a meaningful message.

```js
'use strict'
const pino = require('pino')()
const pinoCaller = require('pino-caller')(pino, { relativeTo: __dirname, stackAdjustment: 1 })

// People who have wrapped pino like in the contrived example below 
// will want to use stackAdjustment.
// Most people will NOT need this.  See issue #90 for details.
const log = {
  info: function(message) { pinoCaller.info(message) }
}
```

### Example output

```
╭─phra at debian in /home/phra/git/pino-caller (master ✔)
╰─λ npm run example

> pino-caller@1.0.0 example /home/phra/git/pino-caller
> env NODE_ENV=development node examples/index.js

{"pid":44837,"hostname":"debian","level":30,"time":1487873713227,"msg":"hello from the module!","caller":"Object.<anonymous> (/home/phra/git/pino-caller/examples/module.js:4:12)","v":1}
{"pid":44837,"hostname":"debian","level":30,"time":1487873713230,"msg":"info1","caller":"Object.<anonymous> (index.js:8:12)","v":1}
{"pid":44837,"hostname":"debian","level":50,"time":1487873713230,"msg":"error1","caller":"Object.<anonymous> (index.js:9:12)","v":1}
```

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