Search documentation

Search by topic, API name, or import path.

GitHub ↗

function / @typed/fx

RefArray.make

Creates a new RefArray from an array, Effect, or Fx.

Package version
2.0.0-beta.7
Category
Constructors
Since
1.18.0
Member of
RefArray

Import

import { RefArray } from "@typed/fx";

Access RefArray.make through the imported RefArray export. Its declaration below describes the member.

This public exposure is a re-export. Its import path is supported; declaration documentation is shared with the other public exposures below.

Signatures

export declare function make<A, E = never, R = never>(initial: ReadonlyArray<A> | Effect.Effect<ReadonlyArray<A>, E, R> | Fx.Fx<ReadonlyArray<A>, E, R>, eq?: Equivalence<A>): Effect.Effect<RefArray<A, E>, never, R | Scope.Scope>;

Why

Creates array state with equality suited to that Effect data type, so unchanged values do not produce redundant pushed updates.

Ownership and lifetime

The creation Effect requires Scope. It owns initializer acquisition, live source subscriptions, and cleanup; source failures and services stay on reads and pushes.

Examples

import { Effect } from "effect"
import * as RefArray from "@typed/fx/RefArray"

// From a plain array
const program1 = Effect.gen(function* () {
  const items = yield* RefArray.make([1, 2, 3])
  const values = yield* items
  console.log(values) // [1, 2, 3]
})

// From an Effect
const program2 = Effect.gen(function* () {
  const items = yield* RefArray.make(
    Effect.succeed(["a", "b", "c"])
  )
  const values = yield* items
  console.log(values) // ["a", "b", "c"]
})

Other public imports

These import paths expose the same declaration. Each page retains its own public name and signature.

Source