{"result":{"depiction_url":null,"edges":{"subject":{"objects":[{"created":"2026-09-30T09:11:23Z","object_id":{"id":2555,"is_a":["categorization","keyword","keyword_information_type"],"name":"zotonic_topic_reference","title":"Reference","uri":"https:\/\/zotonic.com\/id\/2555"},"seq":1},{"created":"2026-09-30T09:11:23Z","object_id":{"id":2563,"is_a":["categorization","keyword","keyword_audience"],"name":"zotonic_topic_frontend_developer","title":"Frontend developer","uri":"https:\/\/zotonic.com\/id\/2563"},"seq":2},{"created":"2026-09-30T09:11:23Z","object_id":{"id":2625,"is_a":["categorization","keyword","keyword_architecture"],"name":"zotonic_topic_model","title":"Model","uri":"https:\/\/zotonic.com\/id\/2625"},"seq":3},{"created":"2026-09-30T09:11:23Z","object_id":{"id":2673,"is_a":["categorization","keyword","keyword_technology"],"name":"zotonic_topic_javascript","title":"JavaScript","uri":"https:\/\/zotonic.com\/id\/2673"},"seq":4},{"created":"2026-09-30T09:11:23Z","object_id":{"id":2714,"is_a":["categorization","keyword","keyword_domain"],"name":"zotonic_topic_browser_navigation","title":"Browser navigation","uri":"https:\/\/zotonic.com\/id\/2714"},"seq":5},{"created":"2026-09-30T09:11:23Z","object_id":{"id":2718,"is_a":["categorization","keyword","keyword_technology"],"name":"zotonic_topic_cotonic","title":"Cotonic","uri":"https:\/\/zotonic.com\/id\/2718"},"seq":6}],"predicate":{"id":308,"is_a":["meta","predicate"],"name":"subject","title":{"_type":"trans","tr":{"en":"Keyword"}},"uri":"http:\/\/purl.org\/dc\/elements\/1.1\/subject"}}},"id":2736,"is_a":["text","documentation","reference","cotonic_reference","cotonic_model"],"links":[{"rel":"self","target":"https:\/\/zotonic.com\/.zotonic\/websub\/topic\/2736"},{"rel":"hub","target":"https:\/\/zotonic.com\/.zotonic\/websub"}],"medium":null,"medium_url":null,"name":"doc_cotonic_model_location","page_url":{"en":"https:\/\/zotonic.com\/cotonic\/models\/location","x-default":"https:\/\/zotonic.com\/cotonic\/models\/location"},"preview_url":null,"resource":{"version":15,"pivot_location_lat":null,"title":"model\/location","is_authoritative":true,"body":"<\/a>

model\/location<\/h3>\n

\n The location model can be used to retrieve information on the current location\n of the page. It also allows subscription to location changes.\n <\/p>\n\n \n <\/a>

get\/href<\/h4>

\n Get the current href.\n <\/p>\n 

\nself.call("model\/location\/get\/href")\n.then(function(m) {\n    console.log(m.payload)\n});\n=> "https:\/\/cotonic.org\/#model.location"<\/pre>\n\n            \n            <\/a>
get\/protocol<\/h4>
\n            Get the current protocol\n            <\/p>\n            
\nself.call("model\/location\/get\/protocol")\n.then(function(m) {\n    console.log(m.payload)\n});\n=> "https"<\/pre>\n\n            \n            <\/a>
get\/host<\/h4>
\n            Get the current host (with port).\n            <\/p>\n            
\nself.call("model\/location\/get\/host")\n.then(function(m) {\n    console.log(m.payload)\n});\n=> "cotonic.org"<\/pre>\n\n            \n            <\/a>
get\/hostname<\/h4>
\n            <\/p>\n            Get the current hostname (without port).\n            
\nself.call("model\/location\/get\/hostname")\n.then(function(m) {\n    console.log(m.payload)\n});\n=> "cotonic.org"<\/pre>\n\n            \n            <\/a>
get\/origin<\/h4>
\n            Get the current origin.\n            <\/p>\n            
\nself.call("model\/location\/get\/origin")\n.then(function(m) {\n    console.log(m.payload)\n});\n=> "https:\/\/cotonic.org"<\/pre>\n\n            \n            <\/a>
get\/pathname<\/h4>
\n            Get the current pathname.\n            <\/p>\n            
\nself.call("model\/location\/get\/pathname")\n.then(function(m) {\n    console.log(m.payload)\n});\n=> "\/"<\/pre>\n\n            \n            <\/a>
get\/port<\/h4>
\n            Get the current port.\n            <\/p>\n            
\ncotonic.broker.call("model\/location\/get\/port")\n.then(function(m) {\n    console.log(m.payload)\n})\n=> "" \/\/ The default port.<\/pre>\n\n\n            \n\n <\/a>
post\/redirect<\/h4>
\n            Redirect the user to another url\n            <\/p>\n            
\ncotonic.broker.publish("model\/location\/post\/redirect", {url: "https:\/\/cotonic.org"})\n=> \/\/ The user is redirect to cotonic.org.<\/pre>\n\n            \n\n<\/a>
post\/redirect\/back<\/h4>
\n            Loads the previous URL (page) in the history list. When there is no page in the\n            history list, a default (local) url can be passed. When no navigation occurs, \n            the user will be redirected to this url.\n<\/p>\n
\ncotonic.broker.publish("model\/location\/post\/redirect\/back", {url: "\/home"})\n=> \/\/ Go back, when there is no page in the history, move to "\/home".<\/pre>\n\n
\n<a data-onclick-topic="model\/location\/post\/redirect\/back" href="\/home">Go Back<\/a>\n<\/pre>\n\n            \n\n <\/a>
post\/reload<\/h4>
\n            Reload the current page. This can be handy when you know something on the server side has\n            changed.\n            <\/p>\n            
\ncotonic.broker.call("model\/location\/post\/reload")\n=> \/\/ The page will reload.\n<\/pre>\n\n
\n<button data-onclick-topic="bridge\/origin\/model\/xyz\/post\/doit"\n        data-onresponse-topic="model\/location\/reload">Do It<\/button>\n\nWhen the xyz model on the server responds, the page will be reloaded\n            <\/pre>\n\n            \n\n <\/a>
post\/q<\/h4>
\n            Updates the current location’s search (query) arguments with the given object of\n            { "key": value }<\/tt> keys. The browsers location is modified using replaceState<\/tt>\n            and the new arguments are posted to model\/location\/event\/q<\/tt> and model\/location\/event\/qlist<\/tt>\n            <\/p>\n            
If you need to have multiple keys with the same name, or the order of the keys is significant then use post\/qlist<\/a>.<\/p>\n            
\ncotonic.broker.call("model\/location\/post\/q", {"a":"1", "b":"2"} ])\n=> \/\/ The browser location will be updated, the page is not reloaded\n<\/pre>\n\n
\n<form data-onsubmit-topic="model\/location\/post\/q">\n   <input type="text" value="">\n   <input type="submit" value="Submit">\n<\/form>\n            <\/pre>\n\n            \n\n <\/a>
post\/qlist<\/h4>
\n            Updates the current location’s search (query) arguments with the given list of\n            [Key, Value]<\/tt> pairs. The browsers location is modified using replaceState<\/tt>\n            and the new arguments are posted to model\/location\/event\/q<\/tt> and model\/location\/event\/qlist<\/tt>\n            <\/p>\n            
\ncotonic.broker.call("model\/location\/post\/qlist", [ ["a", "1"], ["b", "2"] ])\n=> \/\/ The browser location will be updated, the page is not reloaded\n<\/pre>\n\n
\n<form data-onsubmit-topic="model\/location\/post\/qlist">\n   <input type="text" value="">\n   <input type="submit" value="Submit">\n<\/form>\n            <\/pre>\n\n            \n\n <\/a>
post\/push<\/h4>
\n            Updates the current location with the given url. The new location is set using\n            pushState<\/tt>, so the back button will work. The location is assumed to be\n            on the same hostname as the current page, so only the new path, search and hash are\n            pushed.
\n            If parts of the new location are changed then they are posted to model\/location\/event\/pathname<\/tt>, model\/location\/event\/q<\/tt>, model\/location\/event\/qlist<\/tt> and model\/location\/event\/hash<\/tt>.  If the hash is set and there is an element with an id corresponding to the hash, then that element is scrolled into view.\n            <\/p>\n
\ncotonic.broker.call("model\/location\/post\/push", { url: "\/hello?w=world" });\n=> \/\/ The browser location will be updated, the page is not reloaded\n<\/pre>\n\n
\n<a data-onclick-topic="model\/location\/post\/push" href="?a=1">\n<\/pre>\n\n            \n\n <\/a>
post\/replace<\/h4>
\n            Updates the current location with the given url. The new location is set using\n            replaceState<\/tt>, so the back button will NOT work. The location is assumed to be\n            on the same hostname as the current page, so only the new path, search and hash are\n            pushed.
\n            If parts of the new location are changed then they are posted to model\/location\/event\/pathname<\/tt>, model\/location\/event\/q<\/tt>, model\/location\/event\/qlist<\/tt> and model\/location\/event\/hash<\/tt>.  If the hash is set and there is an element with an id corresponding to the hash, then that element is scrolled into view.\n            <\/p>\n
\ncotonic.broker.call("model\/location\/post\/replace", { url: "\/hello?w=world" });\n=> \/\/ The browser location will be updated, the page is not reloaded\n<\/pre>\n\n
\n<a data-onclick-topic="model\/location\/post\/replace" href="?a=1">\n<\/pre>\n\n\n            \n\n <\/a>
post\/push-silent<\/h4>
\n            Updates the current location with the given url. The new location is set using\n            pushState<\/tt>, so the back button will work. The location is assumed to be\n            on the same hostname as the current page, so only the new path, search and hash are\n            pushed.
\n            The new location is silently changed, no location events are published.\n            <\/p>\n
\ncotonic.broker.call("model\/location\/post\/push-silent", { url: "\/hello?w=world" });\n=> \/\/ The browser location will be updated, the page is not reloaded\n<\/pre>\n\n
\n<a data-onclick-topic="model\/location\/post\/push-silent" href="?a=1">\n<\/pre>\n\n            \n\n <\/a>
post\/replace-silent<\/h4>
\n            Updates the current location with the given url. The new location is set using\n            replaceState<\/tt>, so the back button will NOT work. The location is assumed to be\n            on the same hostname as the current page, so only the new path, search and hash are\n            pushed.
\n            The new location is silently changed, no location events are published.\n            <\/p>\n
\ncotonic.broker.call("model\/location\/post\/replace-silent", { url: "\/hello?w=world" });\n=> \/\/ The browser location will be updated, the page is not reloaded\n<\/pre>\n\n
\n<a data-onclick-topic="model\/location\/post\/replace-silent" href="?a=1">\n<\/pre>\n\n            \n            <\/a>
event\/search<\/h4>
\n            A message containing the query string part of the url will be published when it changes.\n            Note: the message is retained<\/em>\n            <\/p>\n            
\ncotonic.broker.subscribe("model\/location\/event\/search",\n    function(m, a) {\n        console.log("query string changed", m.payload);\n});<\/pre>\n\n            \n            <\/a>
event\/pathname<\/h4>
\n            A message containing the pathname part of the url will be published when it changes.\n            Note: the message is retained<\/em>\n            <\/p>\n            
\ncotonic.broker.subscribe("model\/location\/event\/pathname",\n    function(m, a) {\n        console.log("pathname changed", m.payload);\n    });<\/pre>\n\n            \n            <\/a>
event\/hash<\/h4>
\n            A message containing the hash part of the url will be published when it changes.\n            Note: the message is retained<\/em>\n            <\/p>\n            
\ncotonic.broker.subscribe("model\/location\/event\/hash",\n    function(m, a) {\n        console.log("hash changed", m.payload);\n    });<\/pre>\n\n            \n            <\/a>
event\/ping<\/h4>
\n            When the location model is enabled, a retained message is published on this\n            topic. By subscribing to this topic it is possible to see when the model is\n            enabled. The payload of the message pong<\/tt>.\n            <\/p>\n            
\ncotonic.broker.subscribe("model\/location\/event\/ping",\n    function(m) {\n        console.log("The location model is enabled", m.payload)\n    })\n=> Logs a message on the console when the location model is enabled.<\/pre>\n\n            \n            <\/a>
event\/q<\/h4>
\n            A message with the current query arguments is published on this\n            topic. By subscribing to this topic it is possible to see when the query arguments\n            change. The payload of the message is an object with { "key": "value" }<\/tt>\n            entries. Note: the message is retained<\/em>\n            <\/p>\n            
\ncotonic.broker.subscribe("model\/location\/event\/q",\n    function(m) {\n        console.log("New query arguments", m.payload)\n    })\n=> Logs a message on the console when the query arguments change.<\/pre>\n\n            \n            <\/a>
event\/qlist<\/h4>
\n            A message with the current query arguments is published on this\n            topic. By subscribing to this topic it is possible to see when the query arguments\n            change. The payload of the message is an array with [ "key", "value" ]<\/tt> pairs.\n            Note: the message is retained<\/em>\n            <\/p>\n            
\ncotonic.broker.subscribe("model\/location\/event\/qlist",\n    function(m) {\n        console.log("New query arguments", m.payload)\n    })\n=> Logs a message on the console when the query arguments change.<\/pre>\n\n            \n            <\/a>
Configuration<\/em><\/h4>
\n            The location has one configuration option.\n            <\/p>\n            
\n                
pathname_search<\/tt><\/dt>\n                
Set to the current search parameters of the page. Alternatively this setting\n                can can be done as data-cotonic-pathname-search<\/tt> attribute on the body tag.<\/dd>\n            <\/dl>\n\n            
\n<script>\n    window.cotonic = window.cotonic || {};\n    window.cotonic.config = {\n        start_service_worker: true,\n        pathname_search: "q=110&j=yes"\n    };\n<\/script>\n<script src="cotonic.js"><\/script>\n<\/pre>\n            
\n<body data-cotonic-pathname-search="q=110&amp;j=yes">\n...\n<\/body>\n<\/pre>\n\n            ","slug":"model-location","is_protected":false,"visible_for":0,"tz":"UTC","language":["en"],"doc_source_hash":"c8615a5eaca7f49cc03b96369b37cc3a7497a4b03c9dabe65914f49114a4255b","is_featured":false,"content_group_id":{"id":2551,"is_a":["meta","content_group"],"name":"content_group_imported_docs","title":"Imported documentation","uri":"https:\/\/zotonic.com\/id\/content_group_imported_docs"},"category_id":{"id":2723,"is_a":["meta","category"],"name":"cotonic_model","title":"Cotonic models","uri":"https:\/\/zotonic.com\/id\/cotonic_model"},"doc_source_path":"index.html","publication_start":"2026-09-30T09:11:23Z","page_path":"\/cotonic\/models\/location","github_url":"https:\/\/github.com\/cotonic\/cotonic\/blob\/master\/index.html","pivot_location_lng":null,"doc_source_kind":"cotonic","name":"doc_cotonic_model_location","is_unfindable":false,"is_published":true,"pivot_geocode":null,"created":"2026-09-30T09:11:23Z","uri":null,"doc_source_anchor":"model.location","doc_status":"current","is_dependent":false,"publication_end":"9999-06-01T00:00:00Z","modifier_id":{"id":1,"is_a":["person"],"name":"administrator","title":"Site Administrator","uri":"https:\/\/zotonic.com\/id\/1"},"privacy":0,"doc_source_commit":"f88cc928b997d10f7f19e6bd0ede80e1c8c619bc","creator_id":{"id":1,"is_a":["person"],"name":"administrator","title":"Site Administrator","uri":"https:\/\/zotonic.com\/id\/1"},"modified":"2026-09-30T09:57:31Z","title_slug":"model-location"},"uri":"https:\/\/zotonic.com\/id\/2736","uri_template":"https:\/\/zotonic.com\/id\/:id","websub":{"hub":"https:\/\/zotonic.com\/.zotonic\/websub","topic":"https:\/\/zotonic.com\/.zotonic\/websub\/topic\/2736"}},"status":"ok"}