Omitting the parameter returns the current value (getter), whereas defining the parameter sets the value (setter) and returns the instance itself for easier chaining.
Version:
GreenSock Docs
Back to GSAP
Tween
Methods
.delay()
.duration()
.endTime()
.eventCallback()
.from()
.fromTo()
.invalidate()
.isActive()
.iteration()
.kill()
.pause()
.paused()
.play()
.progress()
.repeat()
.repeatDelay()
.restart()
.resume()
.reverse()
.reversed()
.seek()
.set()
.startTime()
.then()
.time()
.timeScale()
.to()
.totalDuration()
.totalProgress()
.totalTime()
.yoyo()
Tween
.iteration()
.iteration( ) : *
Gets or sets the iteration (the current repeat) of tweens.
Returns : *
Details
Gets or sets the iteration (the current repeat) of tweens. For example, if repeat is 4, and the playhead is currently on its third repeat, .iteration() will return 3.
Including a number will cause the tween to jump to iteration number given. For example, if the repeat is 4, and the playhead is currently on its third repeat, .iteration(2) will make the tween jump back to the second iteration.
var progress = myTween.iteration(); //gets current iterationmyTween.iteration( 2 ); //sets iteration the second iteration