my.navigateTo

Use this API to navigate to a new page within the Mini Program. The current page is preserved in the page stack, allowing users to return with my.navigateBack.

Parameters

Property	Type	Required	Description
url	String	Yes	Page path with optional query parameters (format: `path?key=value&key2=value2`)
success	Function	No	Callback on success
fail	Function	No	Callback on failure
complete	Function	No	Callback that always executes

The maximum page stack depth is 10. You can call navigateTo at most 10 times before needing to navigate back or use other navigation methods.

Code Example

my.navigateTo({
  url: 'pages/detail/detail'
});

With Query Parameters

my.navigateTo({
  url: 'pages/detail/detail?id=123&type=product'
});

Receiving Parameters

// In the target page
Page({
  onLoad(query) {
    console.log(query.id);   // '123'
    console.log(query.type); // 'product'

    my.alert({
      content: JSON.stringify(query)
    });
  }
});

With Callbacks

my.navigateTo({
  url: 'pages/checkout/checkout',
  success() {
    console.log('Navigation successful');
  },
  fail(err) {
    console.error('Navigation failed:', err);
    my.showToast({
      content: 'Failed to open page',
      type: 'fail'
    });
  }
});

Use Cases

Navigate to Detail Page

Page({
  onItemTap(e) {
    const { id, name } = e.currentTarget.dataset;
    my.navigateTo({
      url: `pages/detail/detail?id=${id}&name=${encodeURIComponent(name)}`
    });
  }
});

Conditional Navigation

Important Notes

Cannot navigate to tab bar pages (use my.switchTab instead)
Query parameter values should be URL-encoded if they contain special characters
The current page is preserved and can be returned to with my.navigateBack

API	Behavior
`my.navigateTo`	Opens new page, keeps current page in stack
`my.redirectTo`	Replaces current page (cannot go back)
`my.reLaunch`	Closes all pages, opens target page
`my.switchTab`	Navigates to tab page only

my.navigateBack

Go back to previous page

my.redirectTo

Replace current page

my.switchTab my.navigateBack

JSAPI Reference

Basic

In-App Events

UI

Media

Storage

File

Location

Map

Network

Device

Sharing

Collection

Update

Web View

Alipay Connect

Open Capabilities

Other

Parameters

Code Example

Basic Navigation

With Query Parameters

Receiving Parameters

With Callbacks

Use Cases

Important Notes

Differences from Other Navigation APIs

my.navigateBack

my.redirectTo

​Parameters

​Code Example

​Basic Navigation

​With Query Parameters

​Receiving Parameters

​With Callbacks

​Use Cases

​Important Notes

​Differences from Other Navigation APIs

​Related APIs

my.navigateBack

my.redirectTo

Parameters

Code Example

Basic Navigation

With Query Parameters

Receiving Parameters

With Callbacks

Use Cases

Important Notes

Differences from Other Navigation APIs

Related APIs