# WaterHandle

> Talos next · Since 0.7

The scene's water, read-only: the sea, its lakes and rivers, exactly as the engine floats `buoyancy` bodies on them, at `ctx.time.now`.

A replay reads the same numbers.

## Signature

```ts
export interface WaterHandle {
  /**
   * The water at world (x, z), or null where there is none. Throws a `RangeError`
   * (`fluid.sample-invalid`) for a coordinate that is not a finite number.
   */
  sample(x: number, z: number): WaterSample | null
}
```

Import: `import type { WaterHandle } from "@argus/api"`

## Members

| Member | Signature | Description |
|---|---|---|
| `sample` | `sample(x: number, z: number): WaterSample \| null` | The water at world (x, z), or null where there is none. Throws a `RangeError` (`fluid.sample-invalid`) for a coordinate that is not a finite number. |