跳到内容

useObservable

分类
导出大小
225 B
@vueuse/rxjs
最近更改
3 周前

使用 RxJS Observable,返回一个 ref,并在组件卸载时自动取消订阅。可在 @vueuse/rxjs 附加组件中使用。

用法

ts
import { useObservable } from '@vueuse/rxjs'
import { interval } from 'rxjs'
import { mapTo, scan, startWith } from 'rxjs/operators'

// setup()
const count = useObservable(
  interval(1000).pipe(
    mapTo(1),
    startWith(0),
    scan((total, next) => next + total),
  ),
)

如果你想为一个可能出错的 Observable 添加自定义错误处理,你可以提供一个可选的 onError 配置。否则,RxJS 会将提供的 Observable 中的任何错误视为“未处理的错误”,它将在新的调用堆栈中抛出,并报告给 window.onerror (或者如果你在 Node 环境中,则报告给 process.on('error'))。

ts
import { useObservable } from '@vueuse/rxjs'
import { interval } from 'rxjs'
import { map } from 'rxjs/operators'

// setup()
const count = useObservable(
  interval(1000).pipe(
    map((n) => {
      if (n === 10)
        throw new Error('oops')

      return n + n
    }),
  ),
  {
    onError: (err) => {
      console.log(err.message) // "oops"
    },
  },
)

类型声明

typescript
export interface UseObservableOptions<I> {
  onError?: (err: any) => void
  /**
   * The value that should be set if the observable has not emitted.
   */
  initialValue?: I | undefined
}
export declare function useObservable<H, I = undefined>(
  observable: Observable<H>,
  options?: UseObservableOptions<I | undefined>,
): Readonly<Ref<H | I>>

源码

SourceDocs

贡献者

Anthony Fu
Anthony Fu
IlyaL
Curt Grimes
Vincent Schramer
Ben Lesh
Michel Betancourt

更新日志

v12.0.0-beta.1 于 11/21/2024
0a9ed - feat!: 放弃 Vue 2 支持,优化包并清理 (#4349)

在 MIT 许可证下发布。