# nw-app-read

> ## 浏览器H5尝试打开云阅读APP

Latest version **2.9.24** (published 2026-06-08) · 0 weekly downloads

## Install

```sh
npm install nw-app-read
pnpm add nw-app-read
yarn add nw-app-read
bun add nw-app-read
```

## Health

**Score 50/100 (C)** — status: active.

Positive: esm support; no vulnerabilities.

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 2.9.24 |
| Published | 2026-06-08 |
| First published | 2017-11-03 |
| Weekly downloads | 0 |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Dependencies | 4 |
| Unpacked size | 72.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Maintainers | guoyeeg, azgaga, liushichuan, yaochen, shenyuan, aflyermin, ignous, jeekdong, yousy, luofeiyue, whiskeyi, fechen |

## Links

- npm: https://www.npmjs.com/package/nw-app-read
- npm.io page: https://npm.io/package/nw-app-read

## Dependencies (4)

- [qs](https://npm.io/package/qs.md) ^6.5.2
- [nw-detect](https://npm.io/package/nw-detect.md) ^2.31.1
- [nejsbridge](https://npm.io/package/nejsbridge.md) latest
- [babel-plugin-dynamic-import-webpack](https://npm.io/package/babel-plugin-dynamic-import-webpack.md) ^1.0.2

## Recent versions

- 2.9.24 (latest) — 2026-06-08
- 2.9.23 — 2025-06-23
- 2.9.22 — 2025-06-22
- 2.9.21 — 2025-06-22
- 2.9.20 — 2025-04-17
- 2.9.19 — 2025-04-17
- 2.9.18 — 2025-04-10
- 2.9.17 — 2025-04-09
- 2.9.16 — 2025-04-08
- 2.9.15 — 2024-12-11
- 2.9.14 — 2024-12-11
- 2.9.13 — 2024-11-12
- 2.9.12 — 2024-11-11
- 2.9.11 — 2024-04-02
- 2.9.10 — 2024-01-29
- … 56 more at https://npm.io/package/nw-app-read/versions

## README

# nw-app-read

## 浏览器H5尝试打开云阅读APP

`尝试唤起APP，如果未安装APP则跳转下载或wap页面`

## 使用
### 直接引用
下载dist/openapp.js，通过script标签直接引入打包好的文件
```html
<script src="./dist/openapp.js"></script>
<script type="text/javascript">
      NWAppRead.openAppRead({
          path: 'detail',
          query: {
              id: '1b7140a1bb4e4ec3bcbb08e5e0093cee_4' //阅读bookId
          },
          h5Fallback: true
      })

      //指定下载地址
      NWAppRead.openAppRead({
          path: 'detail',
          query: {
              id: '1b7140a1bb4e4ec3bcbb08e5e0093cee_4' //阅读bookId
          },
          downloadUrl: 'http://yuedu.163.com/goto?type=181129001'
      })
</script>
```

### npm包引入
npm: 通过npm引入然后直接调用openAppRead()完成跳转

```javascript
import {openAppRead} from 'nw-app-read'

```


参数为Object类型
如：

| 参数属性 | 类型 | 描述 |
| --- | --- | --- |
| `path` | `String` | `h5跳转应用内页面` |
| `query` | `Object` | `h5跳转应用内页面参数` |
| `h5Fallback` | `Boolean` | `非必须参数，为true时如果跳转不成功打开h5对应页面，而非跳下载(安卓系统和ios9以下的微信内，不跳微信提示页，直接跳h5页面)，默认为false(打不开则跳下载)` |
| `replace` | `Boolean` | `是否使用location.replace去跳转页面，默认为false` |
| `downloadUrl` | `String` | `配置客户端下载地址，默认值为https://yuedu.163.com/download` |


尝试APP打开发现页
```javascript
      openAppRead({
          path: 'webview'
      })
```

尝试APP打开阅读详情页，打不开跳下载
```javascript
    openAppRead({
            path: 'detail',//path='detail'表示使用APP打开详情页面
            query: {
                id: '1b7140a1bb4e4ec3bcbb08e5e0093cee_4'//阅读bookId
            }
        })
```

尝试APP打开资讯详情页，打不开跳下载
```javascript
    openAppRead({
            path: 'news',
            query: {
                id: '0c74e2cb723d4a54a6953ab3317421bb_1', //资讯源id
                cid: 'cb3460f480f54daead3495a4354e147d_1' //资讯文章id
            }
        })
```

尝试APP打开书架
```javascript
      openAppRead({
          path: 'shelf'
      })
```

尝试APP打开包月详情页，IOS客户端不支持shema跳包月详情页，故跳h5页面
```javascript
      openAppRead({
            path: 'baoyue',
            query: {
                id: '60071003'//阅读bookId
            }
      })
```

尝试APP打开充值页
```javascript
      openAppRead({
          path: 'recharge',
          query: {
              aid: '', //活动id，可选
              money: 2000,  //要充值的阅点数，可选
              url: 'https://m.yuedu.163.com/' //要打开的h5页面url，可选
          }
      })
```

尝试APP打开购买页
```javascript
      openAppRead({
          path: 'trade',
          query: {
              id: '5ff9990cb61e418c82ea3d74f83137a8_4', //阅读bookId
              title: '碧台空歌', //书籍title
              full: 0, //0 按章购买 1 全本购买
              url: 'https://m.yuedu.163.com/' //要打开的h5页面url
          }
      })
```

尝试APP打开打包购
```javascript
      openAppRead({
          path: 'packagebuy',
          query: {
              pid: '2260043022', //打包购pid
              url: 'https://m.yuedu.163.com/' //要打开的h5页面url
          }
      })
```

尝试APP打开h5页面，如活动页等
```javascript
    openAppRead({
          path: 'activity',
          query: {
              url: location.href
          }
      })
```

尝试APP打开听书详情页
```javascript
    openAppRead({
            path: 'audio',
            query: {
                id: 'audio_05f871a2e4f04293b9ac1abf95edb912_4' //阅读bookId
            }
        })
```

尝试APP打开书架页(V6.0版本)
```javascript
    openAppRead({
            path: 'bookshelf'
        })
```

尝试APP打开手机号绑定页(V6.0版本)
```javascript
    openAppRead({
            path: 'mobileBind'
        })
```

尝试APP打开排行页(V610版本)
```javascript
    openAppRead({
          path: 'rank',
          query: {
              url: '/store/merged/rankNavi.json?uuid=b5648dd3c4f24d9796f590cd81ca076e&rankType=112',
              title: '排行榜'
          }
      })
```

尝试APP打开书城(V610版本)
```javascript
    openAppRead({
        path: 'bookstore',
        query: {
            tab_index: 1
        }
    })
```

尝试APP打开分类(V610版本)
```javascript
    openAppRead({
        path: 'category',
        query: {
            tab_index:  1,
            sub_tab_index: 2
        }
    })
```

尝试APP打开包月详情页面(V610版本)
```javascript
    openAppRead({
        path: 'package',
        query: {
            baoyue_id: '60077001' //包月id
        }
    })
```

`h5Fallback=true`时尝试APP打开页面，打不开跳h5页面
```javascript
    openAppRead({
            path: 'detail',
            query: {
                id: '1b7140a1bb4e4ec3bcbb08e5e0093cee_4'//阅读bookId
            },
            h5Fallback: true
        })
```

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