Browser

Drop a script tag into any page — or import as an ES module. Same API as the Node.js client. No build step required.

Script tag (CDN)

<script src="https://cdn.jsdelivr.net/npm/@fanar-app/fanar-browser/dist/fanar.min.js"></script>
<script>
  fanar('hello from the browser')
  fanar({ user, cart }).label('checkout')
  fanar(new Error('something went wrong'))
  fanar.time('render').stop()
</script>

ES module

<script type="module">
  import fanar from 'https://cdn.jsdelivr.net/npm/@fanar-app/fanar-browser/dist/index.js'

  fanar('hello')
  fanar({ user, cart }).label('checkout')
  fanar.time('render').stop()
</script>

npm

npm install @fanar-app/fanar-browser

import fanar from '@fanar-app/fanar-browser'

fanar('hello')
fanar({ user, session }).label('auth')
fanar(new Error('oops'))
fanar.time('paint').stop()

API

Call	Description
fanar(value)	Auto-dispatch — string/number → log, object → dump, Error → exception
.label(str)	Chain a label onto any call
.color(str)	Chain a color tag onto any call
fanar.time(label)	Start a named timer — call `.stop()` to send elapsed ms
fanar.query(sql, opts)	Send a SQL query with optional bindings and duration
fanar.clear()	Clear all payloads in the Fanar app
fanar.configure(opts)	Set `host` and `port` (default: `localhost:23517`)

Configuration

fanar.configure({ host: '192.168.1.5', port: 23517 })

CORS

The Fanar app must have CORS enabled to accept requests from browser pages. This is on by default for localhost origins. For remote hosts, set FANAR_CORS_ORIGIN in the Fanar app config.