# appium-flutter-finder

> Finder for Appium Flutter driver

Latest version **0.3.0** (published 2026-07-31) · MIT license · 0 weekly downloads

## Install

```sh
npm install appium-flutter-finder
pnpm add appium-flutter-finder
yarn add appium-flutter-finder
bun add appium-flutter-finder
```

## Health

**Score 75/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score.

Warnings: low downloads; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.3.0 |
| Published | 2026-07-31 |
| First published | 2019-07-22 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 0 |
| Unpacked size | 13.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 539 |
| Author | TruongSinh Tran-Nguyen |
| Maintainers | truongsinh, kazucocoa |
| Keywords | appium, flutter |

## Links

- npm: https://www.npmjs.com/package/appium-flutter-finder
- Repository: https://github.com/appium/appium-flutter-driver
- Homepage: https://github.com/appium/appium-flutter-driver#readme
- Issues: https://github.com/appium/appium-flutter-driver/issues
- npm.io page: https://npm.io/package/appium-flutter-finder

## Recent versions

- 0.3.0 (latest) — 2026-07-31
- 0.2.3 — 2026-07-31
- 0.2.2 — 2026-07-31
- 0.2.1 — 2026-07-31
- 0.2.0 — 2023-10-14
- 0.1.0 — 2021-09-13
- 0.0.22 — 2020-02-13
- 0.0.21 — 2020-02-10
- 0.0.13 — 2019-08-16
- 0.0.12 — 2019-08-05
- 0.0.4 — 2019-07-23
- 0.0.3 — 2019-07-22

## README

# Appium Flutter Finder

Companion `finder` for [Appium Flutter Driver](https://www.npmjs.com/package/appium-flutter-driver), that mimics the API of Flutter Driver's [CommonFinders class](https://api.flutter.dev/flutter/flutter_driver/CommonFinders-class.html). All documentation and examples are available in [Appium Flutter Driver package](https://www.npmjs.com/package/appium-flutter-driver).

## Convert `appium-flutter-finder` to ESM in 0.3.0

`appium-flutter-finder` is now published as an ESM-only package. CommonJS `require()` is no longer supported.

Before:

```js
const finder = require('appium-flutter-finder');
```

After:

```js
import * as finder from 'appium-flutter-finder';
```

Named imports are also supported:

```js
import {byText, byValueKey} from 'appium-flutter-finder';
```

CommonJS projects can use dynamic import:

```js
const finder = await import('appium-flutter-finder');
```

Deep imports from `appium-flutter-finder/build/...` are no longer supported. Import all public APIs from the package root.

# Release

```
$ cd finder/nodejs
$ npm version <major|minor|patch>
$ git commit -am 'chore: bump version of appium-flutter-finder'
$ git tag js-finder-<version number> # e.g. git tag js-finder-0.0.23
$ git push origin js-finder-0.0.23
$ git push origin main
```

## Changelog
- 0.3.0
  - Convert to ESM
- 0.2.1/0.2.2/0.2.3
  - Use ox as format/lint
- 0.2.0
  - Fix type of `matchRoot` and `firstMatchOnly` in `ancestor` and `descendant`
- 0.1.0
  - Add `firstMatchOnly` in `ancestor` and `descendant`
- 0.0.23
  - Fix `ancestor` and `descendant`

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