WP_HTML_Processor::next_visitable_token(): bool

779	private function next_visitable_token(): bool {780		$this->current_element = null;781 782		if ( isset( $this->last_error ) ) {783			return false;784		}785 786		/*787		 * Prime the events if there are none.788		 *789		 * @todo In some cases, probably related to the adoption agency790		 *       algorithm, this call to step() doesn't create any new791		 *       events. Calling it again creates them. Figure out why792		 *       this is and if it's inherent or if it's a bug. Looping793		 *       until there are events or until there are no more794		 *       tokens works in the meantime and isn't obviously wrong.795		 */796		if ( empty( $this->element_queue ) && $this->step() ) {797			return $this->next_visitable_token();798		}799 800		// Process the next event on the queue.801		$this->current_element = array_shift( $this->element_queue );802		if ( ! isset( $this->current_element ) ) {803			// There are no tokens left, so close all remaining open elements.804			while ( $this->state->stack_of_open_elements->pop() ) {805				continue;806			}807 808			return empty( $this->element_queue ) ? false : $this->next_visitable_token();809		}810 811		$is_pop = WP_HTML_Stack_Event::POP === $this->current_element->operation;812 813		/*814		 * The root node only exists in the fragment parser, and closing it815		 * indicates that the parse is complete. Stop before popping it from816		 * the breadcrumbs.817		 */818		if ( 'root-node' === $this->current_element->token->bookmark_name ) {819			return $this->next_visitable_token();820		}821 822		// Adjust the breadcrumbs for this event.823		if ( $is_pop ) {824			array_pop( $this->breadcrumbs );825		} else {826			$this->breadcrumbs[] = $this->current_element->token->node_name;827		}828 829		// Avoid sending close events for elements which don't expect a closing.830		if ( $is_pop && ! $this->expects_closer( $this->current_element->token ) ) {831			return $this->next_visitable_token();832		}833 834		return true;835	}