# testcafe-browser-provider-idevice

> idevice TestCafe browser provider plugin.

Latest version **0.0.188** (published 2021-07-19) · MIT license · 0 weekly downloads

## Install

```sh
npm install testcafe-browser-provider-idevice
pnpm add testcafe-browser-provider-idevice
yarn add testcafe-browser-provider-idevice
bun add testcafe-browser-provider-idevice
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.0.188 |
| Published | 2021-07-19 |
| First published | 2019-03-12 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 1 |
| Unpacked size | 88.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Bradley Smith |
| Maintainers | bsmithb2 |
| Keywords | testcafe, browser provider, plugin |

## Links

- npm: https://www.npmjs.com/package/testcafe-browser-provider-idevice
- Repository: https://github.com/bsmithb2/testcafe-browser-provider-idevice
- Issues: https://github.com/bsmithb2/testcafe-browser-provider-idevice/issues
- npm.io page: https://npm.io/package/testcafe-browser-provider-idevice

## Dependencies (1)

- [babel-runtime](https://npm.io/package/babel-runtime.md) ^6.11.6

## Alternatives

- [@opentelemetry/exporter-zipkin](https://npm.io/package/@opentelemetry/exporter-zipkin.md) — 14.8M weekly downloads
- [pusher-js](https://npm.io/package/pusher-js.md) — 2.0M weekly downloads
- [browserify](https://npm.io/package/browserify.md) — 1.7M weekly downloads
- [sqs-consumer](https://npm.io/package/sqs-consumer.md) — 1.7M weekly downloads
- [@sanity/eventsource](https://npm.io/package/@sanity/eventsource.md) — 930.8K weekly downloads

## Recent versions

- 0.0.188 (latest) — 2021-07-19
- 0.0.115 — 2020-09-02
- 0.0.114 — 2020-09-02
- 0.0.92 — 2020-09-01
- 0.0.90 — 2020-09-01
- 0.0.85 — 2020-09-01
- 0.0.84 — 2020-09-01
- 0.0.83 — 2020-09-01
- 0.0.57 — 2019-03-14
- 0.0.56 — 2019-03-14
- 0.0.55 — 2019-03-14
- 0.0.54 — 2019-03-14
- 0.0.51 — 2019-03-12
- 0.0.50 — 2019-03-12
- 0.0.49 — 2019-03-12

## README

# testcafe-browser-provider-idevice
[![Build Status](https://dev.azure.com/BradleySmith0287/testcafe-browser-provider-android/_apis/build/status/bsmithb2.testcafe-browser-provider-android?branchName=master)](https://dev.azure.com/BradleySmith0287/testcafe-browser-provider-android/_build/latest?definitionId=1&branchName=master)

This is the **idevice** browser provider plugin for [TestCafe](http://devexpress.github.io/testcafe).

## Install

```
npm install testcafe-browser-provider-idevice
```

## Usage


You can determine the available browser aliases by running
```
testcafe -b idevice
```

When you run tests from the command line, use the alias when specifying browsers: 

```
testcafe idevice:browser1 'path/to/test/file.js'
```

A 'browser' is the device you'd like to test in this case. For simulators use "simulator.{simulator Name}"

eg testcafe 'idevice:simulator.iphone 8' 'path/to/test/file.js'

You can find your simulators using

```
xcrun simctl list
```

When you run on a real device, you require a few steps. 
1. Install XCode
2. Open the XCUITest testApplication. 
3. Select your team (Personal is fine). Make sure you do both targets (There's a little dropdown)
4. Run the app
5. Run the test in XCode. Note that the test will fail if you have a code to lock your phone. Remove it, and set your phone to stay unlocked forever. Its a test device. 
6. Run your tests. Make sure the testcafe server (your mac) and the device are accessible and on the same network as each other. If you can't connect then the browser will open, but nothing will load. 

Real devices are configured with their UUID as the device name, for example: 
```
testcafe 'idevice:f655a41e4fe4c7db93571fb143f91a5a4a7c1e34' test.js
```

When you use API, pass the alias to the `browsers()` method:

```js
testCafe
    .createRunner()
    .src('path/to/test/file.js')
    .browsers('idevice:browser1')
    .run();
```

## Author
Bradley Smith (https://bradleysmith.dev)

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