# valueUp()

## `Range.prototype.valueUp()`

The `valueUp()` method increments the range [value](https://range.angular-package.dev/draft/range/accessors/value) of a specified [`Range`](https://range.angular-package.dev/draft/range) object by the range [step](https://range.angular-package.dev/draft/range/accessors/get-step) or given [`stepIncrement`](#stepincrement-number).

{% code title="range.class.ts" %}

```typescript
public valueUp(stepIncrement = 1): this {
  typeof this.value === 'number' && stepIncrement > 0 &&
    this.setValue(this.value + stepIncrement * this.#step);
  return this;
}
```

{% endcode %}

### Parameters

#### `stepIncrement:`[<mark style="color:green;">`number`</mark>](https://www.typescriptlang.org/docs/handbook/basic-types.html#number)

The optional `stepIncrement` parameter of the [`number`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number) type increments the range [`value`](https://range.angular-package.dev/draft/range/accessors/value). If no parameter is passed, `stepIncrement` defaults to **`1`**.

### Return type

#### [<mark style="color:green;">`this`</mark>](https://range.angular-package.dev/draft/range)

### Returns

The **return value** is the [`Range`](https://range.angular-package.dev/draft/range) instance.

## Example usage

```typescript
// Example usage.
import { Range } from '@angular-package/range';

// Create new instance.
// Returns Range {min: 3, max: 27, value: 10} of Range<3, 27, 3>.
const range = new Range(3, 27, 10, 3);

// Returns 10.
range.value;

// Returns 13.
range.valueUp().value;

// Returns 19.
range.valueUp(2).value;
```