pino-transmit-http  

> ATTENTION: draft version, not yet released!

Lead maintainer: Sven Tschui

This is a browser transmit for the Pino logger
that sends log statements created in a browser environment to a remote server using
HTTP calls (XHR, fetch or sendBeacon depending on availability).

You can use it like so:

``sh
$ npm install pino pino-transmit-http
`

`js
const pino = require('pino');
const pinoTransmitHttp = require('pino-transmit-http');

const logger = pino({
browser: {
trasmit: pinoTransmitHttp()
}
})

logger.warn('hello pino')
`

A HTTP request will by default look like this

`json
POST /log
Content-Type: application/json;charset=UTF-8

[{"ts":1531919330334,"messages":["hello pino"],"bindings":[],"level":{"label":"warn","value":40}}]
`

Options that can be passed to pinoTransmitHttp({ ... }):

key | default | description
--- | --- | ---
throttle | 500 | Amount of milliseconds to throttle the transmission of the log messages. Note that trailing = true, leading = false is used. See lodash.throttle
debounce | null | Amount of milliseconds to debounce the transmission of the log messages. See lodash.debounce. If null then throttling is used
url | '/log' | location where to send logs
useSendBeacon | true | whether navigator.sendBeacon should be used on unload. Note that sendBeacon has various restriction. It operations on method POST only and can not send custom HTTP headers. content-type is always text/plain.
forceSendBeacon | false | The transmit will fallback to XHR or fetch when a HTTP method other than POST or custom http headers are used since this is not supported by sendBeacon. With forceSendBeacon you can disable the fallback and use sendBeacon anyway. Note that in this case the log calls made using sendBeacon are issued as HTTP POST and without any custom headers.
method | 'POST' | method to be used by XHR and fetch calls. Note that when you pass in a method other than POST, sendBeacon will not be used unless you pass forceSendBeacon.
headers | { 'content-type': 'application/json;charset=UTF-8' } for XHR and fetch calls. Not supported for sendBeacon calls | headers added to XHR and fetch calls. Note that when you pass in custom headers sendBeacon will not be used unless you pass forceSendBeacon.
fetch | null` | fetch instance to be used instead of the global fetch variable