Add skipping methods to main class

src/TapeFromCallable.js

@@ -19,7 +19,7 @@ export default class TapeFromCallable {
 	}
 
 	/**
-	 * Returns the next token in the tape or {@link TapeFromCallable#eof}
+	 * Returns the next token on the tape or {@link TapeFromCallable#eof}
 	 * if the tape has been exhausted.
 	 *
 	 * @returns {Object}
@@ -37,10 +37,10 @@ export default class TapeFromCallable {
 	}
 
 	/**
-	 * Puts a token back in the tape. If {@link TapeFromCallable#read} is
+	 * Puts a token back on the tape. If {@link TapeFromCallable#read} is
 	 * used just after, this token will be returned.
 	 *
-	 * @param {Object} token - The token to put back in the tape.
+	 * @param {Object} token - The token to put back on the tape.
 	 * @returns {TapeFromCallable} Self, for chaining.
 	 */
 	unread ( token ) {
@@ -52,4 +52,25 @@ export default class TapeFromCallable {
 
 	}
 
+	/**
+	 * Skips the next token on the tape.
+	 */
+	async skip ( ) {
+
+		if ( this.buffer.length > 0 ) this.buffer.pop( ) ;
+		else await this.callable( ) ;
+
+	}
+
+	/**
+	 * Skip the next `n` tokens on the tape.
+	 *
+	 * @param {Number} n - The number of tokens to skip.
+	 */
+	async skipMany ( n ) {
+
+		while ( n --> 0 ) await this.skip() ;
+
+	}
+
 }

test/src/abracadabra.js

@@ -6,6 +6,8 @@ import tape from '../../src' ;
  * @test {fromString}
  * @test {TapeFromCallable#read}
  * @test {TapeFromCallable#unread}
+ * @test {TapeFromCallable#skip}
+ * @test {TapeFromCallable#skipMany}
  */
 test( 'As a promise' , t => {
 
@@ -20,18 +22,15 @@ test( 'As a promise' , t => {
 		.then( c => t.is(c, 'X') )
 		.then( () => myTape.read() )
 		.then( c => t.is(c, 'Z') )
+		.then( () => myTape.skipMany(0) )
 		.then( () => myTape.read() )
 		.then( c => t.is(c, 'r') )
 		.then( () => myTape.read() )
 		.then( c => t.is(c, 'a') )
-		.then( () => myTape.read() )
-		.then( c => t.is(c, 'c') )
-		.then( () => myTape.read() )
-		.then( c => t.is(c, 'a') )
+		.then( () => myTape.skipMany(2) )
 		.then( () => myTape.read() )
 		.then( c => t.is(c, 'd') )
-		.then( () => myTape.read() )
-		.then( c => t.is(c, 'a') )
+		.then( () => myTape.skip() )
 		.then( () => myTape.read() )
 		.then( c => t.is(c, 'b') )
 		.then( () => myTape.read() )