ferret/pkg/stdlib/html/navigate_forward.go

package html

import (
	"context"
	"github.com/MontFerret/ferret/pkg/html/dynamic"
	"github.com/MontFerret/ferret/pkg/runtime/core"
	"github.com/MontFerret/ferret/pkg/runtime/values"
)

/*
 * Navigates a document forward within its navigation history.
 * The operation blocks the execution until the page gets loaded.
 * If the history is empty, the function returns FALSE.
 * @param doc (Document) - Target document.
 * @param entry (Int, optional) - Optional value indicating how many pages to skip. Default 1.
 * @param timeout (Int, optional) - Optional timeout. Default is 5000.
 * @returns (Boolean) - Returns TRUE if history exists and the operation succeeded, otherwise FALSE.
 */
func NavigateForward(_ context.Context, args ...core.Value) (core.Value, error) {
	err := core.ValidateArgs(args, 1, 3)

	if err != nil {
		return values.False, err
	}

	err = core.ValidateType(args[0], core.HTMLDocumentType)

	if err != nil {
		return values.None, err
	}

	doc, ok := args[0].(*dynamic.HTMLDocument)

	if !ok {
		return values.False, core.Errors(core.ErrInvalidType, ErrNotDynamic)
	}

	skip := values.NewInt(1)
	timeout := values.NewInt(defaultTimeout)

	if len(args) > 1 {
		err = core.ValidateType(args[1], core.IntType)

		if err != nil {
			return values.None, err
		}

		skip = args[1].(values.Int)
	}

	if len(args) > 2 {
		err = core.ValidateType(args[2], core.IntType)

		if err != nil {
			return values.None, err
		}

		timeout = args[2].(values.Int)
	}

	return doc.NavigateForward(skip, timeout)
}