> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# Method name: onRepeat(handler: Function)

# Method package: wixAnimationsFrontend

# Method menu location: wixAnimationsFrontend --> TimeLine --> onRepeat

# Method Link: https://dev.wix.com/docs/velo/velo-only-apis/wix-animations-frontend/time-line/on-repeat.md

# Method Description:

Sets an event handler that runs when a the timeline repeats.

The event handler set by calling the `onRepeat()` function runs when a
 timeline begins playing a repetition. It does not run for the initial
 play of the timeline. However, when replaying a timeline that has already
 been played, the event handler runs even for the first repetition of
 the timeline.

 If an event handler is already set for `onRepeat`, setting a new event
 handler overrides the one set previously.

 To remove an event handler you set previously, call the `onRepeat()`
 function and pass `null` for the `handler` parameter.



# Method Code Examples:

*** Note: do not assume any prop names or enum values other than the ones in the example.

## Set an event handler that runs when a timeline repeats

```javascript
import wixAnimationsFrontend from 'wix-animations-frontend';

let timeline = wixAnimationsFrontend.timeline({"repeat": 3});

// ...

timeline.onRepeat( () => {
  // handle timeline repetition
  console.log("Timeline is repeating.");
} );
```

## Remove the event handler that runs when a timeline repeats

```javascript
import wixAnimationsFrontend from 'wix-animations-frontend';

let timeline = wixAnimationsFrontend.timeline();

// ...

timeline.onRepeat( null );
```

## Display a message when a timeline repeats

```javascript
import wixAnimationsFrontend from 'wix-animations-frontend';

let timeline = wixAnimationsFrontend.timeline({"repeat": 3});

$w.onReady( function () {
  const myImage = $w("#myImage");

  timeline
    .add( myImage, {
      "rotate": 360,
      "scale": .5,
      "duration": 1000
    } )
    .add( myImage, {
      "opacity": 0,
      "duration": 1000
    } )
    .onRepeat( () => {
      $w("#messageText").text = "Timeline is repeating.";
    } )
    .play();
} );
```

---