# @robingenz/capacitor-firebase-performance

> Capacitor plugin for Firebase Performance Monitoring.

Latest version **1.4.0** (published 2022-03-08) · MIT license · 0 weekly downloads

> **Deprecated.** This package is deprecated.

## Install

```sh
npm install @robingenz/capacitor-firebase-performance
pnpm add @robingenz/capacitor-firebase-performance
yarn add @robingenz/capacitor-firebase-performance
bun add @robingenz/capacitor-firebase-performance
```

## Health

**Score 10/100 (F)** — status: deprecated.

Negative: deprecated.

## Facts

| | |
|---|---|
| Version | 1.4.0 |
| Published | 2022-03-08 |
| First published | 2021-03-27 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 0 |
| Unpacked size | 52.5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 1 |
| Author | Robin Genz |
| Maintainers | robingenz |
| Keywords | capacitor, plugin, native |

## Links

- npm: https://www.npmjs.com/package/@robingenz/capacitor-firebase-performance
- Repository: https://github.com/robingenz/capacitor-firebase-performance
- Homepage: https://github.com/robingenz/capacitor-firebase-performance#readme
- Issues: https://github.com/robingenz/capacitor-firebase-performance/issues
- npm.io page: https://npm.io/package/@robingenz/capacitor-firebase-performance

## Recent versions

- 1.4.0 (latest) — 2022-03-08
- 1.2.0-dev.8b59a2d.1630185994 (dev) — 2021-08-28
- 1.3.1 — 2022-01-26
- 1.3.0 — 2021-08-28
- 1.2.0-dev.aaa18e7.1630185892 — 2021-08-28
- 1.2.0 — 2021-07-31
- 1.1.0 — 2021-07-02
- 1.0.0 — 2021-03-28
- 0.0.1-dev.5316e97 — 2021-03-27

## README

<p align="center"><br><img src="https://user-images.githubusercontent.com/236501/85893648-1c92e880-b7a8-11ea-926d-95355b8175c7.png" width="128" height="128" /></p>
<h3 align="center">Firebase Performance</h3>
<p align="center"><strong><code>@robingenz/capacitor-firebase-performance</code></strong></p>
<p align="center">
  Capacitor plugin for <a href="https://firebase.google.com/docs/perf-mon">Firebase Performance Monitoring</a>. 
</p>

<p align="center">
  <img src="https://img.shields.io/maintenance/yes/2022?style=flat-square" />
  <a href="https://github.com/robingenz/capacitor-firebase-performance/actions?query=workflow%3A%22CI%22"><img src="https://img.shields.io/github/workflow/status/robingenz/capacitor-firebase-performance/CI/main?style=flat-square" /></a>
  <a href="https://www.npmjs.com/package/@robingenz/capacitor-firebase-performance"><img src="https://img.shields.io/npm/l/@robingenz/capacitor-firebase-performance?style=flat-square" /></a>
<br>
  <a href="https://www.npmjs.com/package/@robingenz/capacitor-firebase-performance"><img src="https://img.shields.io/npm/dw/@robingenz/capacitor-firebase-performance?style=flat-square" /></a>
  <a href="https://www.npmjs.com/package/@robingenz/capacitor-firebase-performance"><img src="https://img.shields.io/npm/v/@robingenz/capacitor-firebase-performance?style=flat-square" /></a>
<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
<a href="#contributors-"><img src="https://img.shields.io/badge/all%20contributors-1-orange?style=flat-square" /></a>
<!-- ALL-CONTRIBUTORS-BADGE:END -->
</p>

## Maintainers

| Maintainer | GitHub                                    | Social                                        |
| ---------- | ----------------------------------------- | --------------------------------------------- |
| Robin Genz | [robingenz](https://github.com/robingenz) | [@robin_genz](https://twitter.com/robin_genz) |

## Installation

```bash
npm install @robingenz/capacitor-firebase-performance firebase
npx cap sync
```

Add Firebase to your project if you haven't already ([Android](https://firebase.google.com/docs/android/setup) / [iOS](https://firebase.google.com/docs/ios/setup) / [Web](https://firebase.google.com/docs/web/setup)).

### Android

See [Add the Performance Monitoring plugin to your app](https://firebase.google.com/docs/perf-mon/get-started-android#add-perfmon-plugin) and follow the instructions to set up your app correctly.

#### Variables

This plugin will use the following project variables (defined in your app’s `variables.gradle` file):
- `$firebasePerfVersion` version of `com.google.firebase:firebase-perf` (default: `20.0.5`)

## Configuration

No configuration required for this plugin.

## Demo

A working example can be found here: [robingenz/capacitor-firebase-plugin-demo](https://github.com/robingenz/capacitor-firebase-plugin-demo)

## Usage

```typescript
import { FirebasePerformance } from '@robingenz/capacitor-firebase-performance';

const startTrace = async () => {
  await FirebasePerformance.startTrace({ traceName: 'test_trace' });
};

const stopTrace = async () => {
  await FirebasePerformance.stopTrace({ traceName: 'test_trace' });
};

const incrementMetric = async () => {
  await FirebasePerformance.incrementMetric({ 
    traceName: 'test_trace', 
    metricName: 'item_cache_hit', 
    incrementBy: 1 
  });
};

const setPerformanceCollectionEnabled = async () => {
  await FirebasePerformance.setPerformanceCollectionEnabled({ enabled: true });
};

const isPerformanceCollectionEnabled = async () => {
  const result = await FirebasePerformance.isPerformanceCollectionEnabled();
  return result.enabled;
};
```

## API

<docgen-index>

* [`startTrace(...)`](#starttrace)
* [`stopTrace(...)`](#stoptrace)
* [`incrementMetric(...)`](#incrementmetric)
* [`setPerformanceCollectionEnabled(...)`](#setperformancecollectionenabled)
* [`isPerformanceCollectionEnabled()`](#isperformancecollectionenabled)
* [Interfaces](#interfaces)

</docgen-index>

<docgen-api>
<!--Update the source file JSDoc comments and rerun docgen to update the docs below-->

### startTrace(...)

```typescript
startTrace(options: StartTraceOptions) => Promise<void>
```

Starts a trace.

| Param         | Type                                                            |
| ------------- | --------------------------------------------------------------- |
| **`options`** | <code><a href="#starttraceoptions">StartTraceOptions</a></code> |

--------------------


### stopTrace(...)

```typescript
stopTrace(options: StopTraceOptions) => Promise<void>
```

Stops a trace.

| Param         | Type                                                          |
| ------------- | ------------------------------------------------------------- |
| **`options`** | <code><a href="#stoptraceoptions">StopTraceOptions</a></code> |

--------------------


### incrementMetric(...)

```typescript
incrementMetric(options: IncrementMetricOptions) => Promise<void>
```

Atomically increments the metric with the given name for the selected trace by the `incrementBy` value.

| Param         | Type                                                                      |
| ------------- | ------------------------------------------------------------------------- |
| **`options`** | <code><a href="#incrementmetricoptions">IncrementMetricOptions</a></code> |

--------------------


### setPerformanceCollectionEnabled(...)

```typescript
setPerformanceCollectionEnabled(options: SetPerformanceCollectionEnabledOptions) => Promise<void>
```

Enables or disables performance monitoring.
Will be applied with the next start of the app.

| Param         | Type                                                                                                      |
| ------------- | --------------------------------------------------------------------------------------------------------- |
| **`options`** | <code><a href="#setperformancecollectionenabledoptions">SetPerformanceCollectionEnabledOptions</a></code> |

--------------------


### isPerformanceCollectionEnabled()

```typescript
isPerformanceCollectionEnabled() => Promise<IsPerformanceCollectionEnabledResult>
```

Determines whether performance monitoring is enabled or disabled.

**Returns:** <code>Promise&lt;<a href="#isperformancecollectionenabledresult">IsPerformanceCollectionEnabledResult</a>&gt;</code>

--------------------


### Interfaces


#### StartTraceOptions

| Prop            | Type                | Description                                                                                                                                                                                     |
| --------------- | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **`traceName`** | <code>string</code> | Custom trace name. Names for custom code traces must meet the following requirements: no leading or trailing whitespace, no leading underscore (_) character, and max length is 100 characters. |


#### StopTraceOptions

| Prop            | Type                | Description                                       |
| --------------- | ------------------- | ------------------------------------------------- |
| **`traceName`** | <code>string</code> | Name of the trace that was set with `startTrace`. |


#### IncrementMetricOptions

| Prop              | Type                | Description                                                    |
| ----------------- | ------------------- | -------------------------------------------------------------- |
| **`traceName`**   | <code>string</code> | Name of the trace that was set with `startTrace`.              |
| **`metricName`**  | <code>string</code> | Name of the metric to be incremented.                          |
| **`incrementBy`** | <code>number</code> | Amount by which the metric has to be incremented. Default: `1` |


#### SetPerformanceCollectionEnabledOptions

| Prop          | Type                 | Description                               |
| ------------- | -------------------- | ----------------------------------------- |
| **`enabled`** | <code>boolean</code> | Should performance monitoring be enabled. |


#### IsPerformanceCollectionEnabledResult

| Prop          | Type                 | Description                                                     |
| ------------- | -------------------- | --------------------------------------------------------------- |
| **`enabled`** | <code>boolean</code> | `true` if performance monitoring is enabled, otherwise `false`. |

</docgen-api>

## Changelog

See [CHANGELOG.md](https://github.com/robingenz/capacitor-firebase-performance/blob/master/CHANGELOG.md).

## License

See [LICENSE](https://github.com/robingenz/capacitor-firebase-performance/blob/master/LICENSE).

---
_Source: https://npm.io/package/@robingenz/capacitor-firebase-performance · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._