Defines a backend function that can be called from the frontend.
The webMethod()
function is a wrapper used to export functions from backend code that can be called from the frontend.
The permissions
parameter is used to define the permissions needed to call the function in frontend code. Import
the Permissions
enum from the wix-web-module
module to define the permissions.
The permission options are:
Permissions.Anyone
: Any site visitor can call the function.Permissions.Admin
: Only site admins can call the function.Permissions.SiteMember
: Only site members can call the function.The cache
object, found in the options
parameter, allows you to cache or temporarily store the return values of your backend functions for a specified duration. Use the ttl
property to define the duration, in seconds, for which you want your return value to be cached. If the Time To Live (TTL) is not set, the default value is 604800
seconds, which is approximately 1 week.
Assign identifiers to your cached return values using the tags
property of the cache
object. Tags enable you to specify cached return values that may require invalidation due to significant changes in your data. To invalidate your caches, use the invalidateCache()
function from wix-cache-backend
. Once invalidated, the return value will be re-cached the next time your backend function is called.
Important:
tags
property is required for caching. Without tags, nothing will be cached.invalidateCache()
method from wix-cache-backend is currently in developer preview.Web methods must be defined in files with a .web.js
extension.
Permissions needed to call the function in frontend code.
Function to export.
Caching options.