> ## Documentation Index
> Fetch the complete documentation index at: https://rive.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Expectation

Represents an expectation used within a test case. Each method performs an
assertion comparing the supplied value to the expected one.

## Fields

### `never`

Returns an [Expectation](/docs/scripting/api-reference/testing/expectation) that negates the subsequent assertion.

```lua theme={null}
expect(5).never.is(3)
expect(5).never.greaterThan(10)
```

## Methods

### `is`

<div class="signature">
  ```lua theme={null}
  is(any) -> ()
  ```
</div>

Asserts that the value equals the expected value.

```lua theme={null}
expect(5).is(5)
expect("hello").is("hello")
```

### `greaterThan`

<div class="signature">
  ```lua theme={null}
  greaterThan(any) -> ()
  ```
</div>

Asserts that the value is greater than the expected value.

```lua theme={null}
expect(10).greaterThan(5)
```

### `lessThan`

<div class="signature">
  ```lua theme={null}
  lessThan(any) -> ()
  ```
</div>

Asserts that the value is less than the expected value.

```lua theme={null}
expect(3).lessThan(10)
```

### `greaterThanOrEqual`

<div class="signature">
  ```lua theme={null}
  greaterThanOrEqual(any) -> ()
  ```
</div>

Asserts that the value is greater than or equal to the expected value.

```lua theme={null}
expect(5).greaterThanOrEqual(5)
expect(6).greaterThanOrEqual(5)
```

### `lessThanOrEqual`

<div class="signature">
  ```lua theme={null}
  lessThanOrEqual(any) -> ()
  ```
</div>

Asserts that the value is less than or equal to the expected value.

```lua theme={null}
expect(5).lessThanOrEqual(5)
expect(4).lessThanOrEqual(5)
```