---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# UriMatcherResponse -- Umfang

# UriMatcherResponse -- Umfang {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 Minuten Lesedauer

Stellt Methoden bereit, um Informationen darüber zurückzugeben, ob ein URI den angegebenen Kriterien für Schema, Host, Pfad, Fragmente und Vorhandensein von Abfrageparametern entspricht.

Verwenden Sie diese API mit UriMatcher API. Diese API hat keinen Konstruktor. Verwenden Sie stattdessen [UriMatcher -- Match()](https://servicenow-prod.fluidtopics.net/XsXCNd84yetBw~67Vsxywg#UriMatcher-match_S_S_O_O_O_B "Überprüft, ob ein URI den angegebenen Kriterien für Schema, Host, Pfad, Fragmente und Vorhandensein von Abfrageparametern entspricht.")Methode zum Instanziieren von UriMatcherResponse Objekt.

Die UriMatcherResponse API erfordert das Plugin „REST-API-Anbieter" (com.Glide.Rest), das standardmäßig aktiviert ist.

Diese API wird in bereitgestellt `sn_WS `Namespace.

## UriMatcherResponse -- getErrorMessages() {#ariaid-title2}

Gibt Nachrichten zu Fehlern zurück, die beim Testen des URI anhand der angegebenen Kriterien aufgetreten sind.
{#UriMatcherResp-getErrorMessages__table_ymw_1zt_rdc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 1. Parameter]

{#UriMatcherResp-getErrorMessages__table_ymw_1zt_rdc} {#UriMatcherResp-getErrorMessages__table_zmw_1zt_rdc__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Beschreibung des aufgetretenen Fehlers. Wenn kein Fehler aufgetreten ist, wird eine leere Zeichenfolge zurückgegeben. |
[Tabelle : 2. Rückgaben]

{#UriMatcherResp-getErrorMessages__table_zmw_1zt_rdc}  
Dieses Beispiel gibt einen Fehler zurück, da in den Übereinstimmungskriterien kein Host angegeben wurde.

    var uri = "https://example.com";
    var scheme = "https";    
    var matcher = new sn_ws.UriMatcher();  
    var resp = matcher.match(uri, scheme);  

    gs.info("Error occurred: " + resp.isError());  
    gs.info("Error message: " + resp.getErrorMessages());

Ausgabe:

    Error occurred: true
    Error message: Hosts rule is null or empty.

## UriMatcherResponse -- isError() {#ariaid-title3}

Überprüft, ob beim Testen des URI anhand der angegebenen Kriterien ein Fehler aufgetreten ist.
{#UriMatcherResp-isError__table_mh3_xyt_rdc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 3. Parameter]

{#UriMatcherResp-isError__table_mh3_xyt_rdc} {#UriMatcherResp-isError__table_nh3_xyt_rdc__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob ein Fehler aufgetreten ist. Gültige Werte: * Wahr: Ein Fehler ist aufgetreten. * Falsch: Es sind keine Fehler aufgetreten. {#UriMatcherResp-isError__ul_wxh_2t4_sdc} |
[Tabelle : 4. Rückgaben]

{#UriMatcherResp-isError__table_nh3_xyt_rdc}  
Dieses Beispiel gibt einen Fehler zurück, da der URI Abfrageparameter enthält. Der Fehler tritt auf, da das Argument an übergeben wurde Übereinstimmung() Für disallowQueryParametersIst `Wahr `.

    var uri = "https://example.com/path1/more?q=query";
    var scheme = "https";  
    var allowedHosts = ["example.com", "sample.com"];  
    var allowedPaths = ["/path1/more", "/path2/less"];  
    var allowedFragments = ["section1", "section2"];  
    var noQueryParams = true;
    var matcher = new sn_ws.UriMatcher();  
    var resp = matcher.match(uri, scheme, allowedHosts, allowedPaths, allowedFragments, noQueryParams);  

    gs.info("Error occurred: " + resp.isError());  
    gs.info("Error message: " + resp.getErrorMessages());

Ausgabe:

    Error occurred: true
    Error message: Query parameters are not allowed for matching.

## UriMatcherResponse -- isFragmentMatches() {#ariaid-title4}

Überprüft, ob der URI den Kriterien für Fragmente entspricht.
{#UriMatcherResp-isFragmentMatches__table_vls_lzt_rdc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 5. Parameter]

{#UriMatcherResp-isFragmentMatches__table_vls_lzt_rdc} {#UriMatcherResp-isFragmentMatches__table_wls_lzt_rdc__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob der URI den Kriterien für Fragmente entspricht. Gültige Werte: * Wahr: Der URI entspricht den Kriterien für Fragmente. * Falsch: Der URI stimmt nicht mit den Kriterien für Fragmente überein. {#UriMatcherResp-isFragmentMatches__ul_mgr_ckp_sdc} |
[Tabelle : 6. Rückgaben]

{#UriMatcherResp-isFragmentMatches__table_wls_lzt_rdc}  
Dieses Beispiel zeigt, dass der URI den Kriterien nicht entspricht, da er ein Fragment enthält, das nicht in der Liste der zulässigen Fragmente enthalten ist.

    var uri = "https://example.com/path1/more#section3";
    var scheme = "https";  
    var allowedHosts = ["example.com", "sample.com"];  
    var allowedPaths = ["/path1/more", "/path2/less"];  
    var allowedFragments = ["section1", "section2"];  
    var matcher = new sn_ws.UriMatcher();  
    var resp = matcher.match(uri, scheme, allowedHosts, allowedPaths, allowedFragments);  

    gs.info("Is URI a match: " + resp.isMatch());  
    gs.info("Is scheme a match: " + resp.isSchemeMatches());  
    gs.info("Is host a match: " + resp.isHostMatches());  
    gs.info("Is path a match: " + resp.isPathMatches());  
    gs.info("Is fragment a match: " + resp.isFragmentMatches());
    gs.info("Error occurred: " + resp.isError());

Ausgabe:

    Is URI a match: false
    Is scheme a match: true
    Is host a match: true
    Is path a match: true
    Is fragment a match: false
    Error occurred: false

## UriMatcherResponse -- isHostMatches() {#ariaid-title5}

Überprüft, ob der URI den Kriterien für den Host entspricht.
{#UriMatcherResp-isHostMatches__table_igl_hzt_rdc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 7. Parameter]

{#UriMatcherResp-isHostMatches__table_igl_hzt_rdc} {#UriMatcherResp-isHostMatches__table_jgl_hzt_rdc__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob der URI den Kriterien für den Host entspricht. Gültige Werte: * Wahr: Der URI entspricht den Kriterien für den Host. * Falsch: Der URI stimmt nicht mit den Kriterien für den Host überein. {#UriMatcherResp-isHostMatches__ul_dks_slp_sdc} |
[Tabelle : 8. Rückgaben]

{#UriMatcherResp-isHostMatches__table_jgl_hzt_rdc}  
Dieses Beispiel überprüft, ob die URI dem angegebenen Schema und Host entspricht.

    var uri = "https://example.com/path?q=query";
    var scheme = "https";  
    var allowedHosts = ["example.com"];  
    var matcher = new sn_ws.UriMatcher();  
    var resp = matcher.match(uri, scheme, allowedHosts);  

    gs.info("Is URI a match: " + resp.isMatch());
    gs.info("Is host a match: " + resp.isHostMatches());

Ausgabe:

    Is URI a match: true
    Is host a match: true

## UriMatcherResponse -- isMatch() {#ariaid-title6}

Überprüft, ob der URI allen angegebenen Kriterien entspricht.
{#UriMatcherResp-isMatch__table_gzs_tyt_rdc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 9. Parameter]

{#UriMatcherResp-isMatch__table_gzs_tyt_rdc} {#UriMatcherResp-isMatch__table_hzs_tyt_rdc__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob der URI allen angegebenen Kriterien entspricht. Gültige Werte: * Wahr: Der URI entspricht allen Kriterien. * Falsch: Der URI stimmt nicht mit allen Kriterien überein. {#UriMatcherResp-isMatch__ul_dks_slp_sdc} |
[Tabelle : 10. Rückgaben]

{#UriMatcherResp-isMatch__table_hzs_tyt_rdc}  
Dieses Beispiel überprüft, ob die URI dem angegebenen Schema und Host entspricht.

    var uri = "https://example.com/path?q=query";
    var scheme = "https";  
    var allowedHosts = ["example.com"];  
    var matcher = new sn_ws.UriMatcher();  
    var resp = matcher.match(uri, scheme, allowedHosts);  

    gs.info("Is URI a match: " + resp.isMatch());

Ausgabe:

    Is URI a match: true

## UriMatcherResponse -- isPathMatches() {#ariaid-title7}

Überprüft, ob der URI den Kriterien für den Pfad entspricht.
{#UriMatcherResp-isPathMatches__table_a5x_3zt_rdc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 11. Parameter]

{#UriMatcherResp-isPathMatches__table_a5x_3zt_rdc} {#UriMatcherResp-isPathMatches__table_b5x_3zt_rdc__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob der URI den Kriterien für den Pfad entspricht. Gültige Werte: * Wahr: Der URI entspricht den Kriterien für den Pfad. * Falsch: Der URI stimmt nicht mit den Kriterien für den Pfad überein. {#UriMatcherResp-isPathMatches__ul_dks_slp_sdc} |
[Tabelle : 12. Rückgaben]

{#UriMatcherResp-isPathMatches__table_b5x_3zt_rdc}  
Dieses Beispiel überprüft, ob die URI mit dem angegebenen Schema, dem angegebenen Host und dem angegebenen Pfad übereinstimmt.

    var uri = "https://example.com/path1/more";
    var scheme = "https";  
    var allowedHosts = ["example.com", "sample.com"];  
    var allowedPaths = ["/path1/more", "/path2/less"];  
    var matcher = new sn_ws.UriMatcher();  
    var resp = matcher.match(uri, scheme, allowedHosts, allowedPaths);  

    gs.info("Is URI a match: " + resp.isMatch());  
    gs.info("Is scheme a match: " + resp.isSchemeMatches());  
    gs.info("Is host a match: " + resp.isHostMatches());  
    gs.info("Is path a match: " + resp.isPathMatches());  
    gs.info("Is fragment a match: " + resp.isFragmentMatches());
    gs.info("Error occurred: " + resp.isError());

Ausgabe:

    Is URI a match: true
    Is scheme a match: true
    Is host a match: true
    Is path a match: true
    Is fragment a match: true
    Error occurred: false

## UriMatcherResponse -- isSchemeMatches() {#ariaid-title8}

Überprüft, ob der URI den Kriterien für das Schema entspricht.
{#UriMatcherResp-isSchemeMatches__table_p54_dzt_rdc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 13. Parameter]

{#UriMatcherResp-isSchemeMatches__table_p54_dzt_rdc} {#UriMatcherResp-isSchemeMatches__table_q54_dzt_rdc__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob der URI den Kriterien für das Schema entspricht. Gültige Werte: * Wahr: Der URI entspricht den Kriterien für das Schema. * Falsch: Der URI stimmt nicht mit den Kriterien für das Schema überein. {#UriMatcherResp-isSchemeMatches__ul_dks_slp_sdc} |
[Tabelle : 14. Rückgaben]

{#UriMatcherResp-isSchemeMatches__table_q54_dzt_rdc}  
Dieses Beispiel überprüft, ob die URI dem angegebenen Schema und Host entspricht.

    var uri = "https://example.com/path?q=query";
    var scheme = "https";  
    var allowedHosts = ["example.com"];  
    var matcher = new sn_ws.UriMatcher();  
    var resp = matcher.match(uri, scheme, allowedHosts);  

    gs.info("Is URI a match: " + resp.isMatch());
    gs.info("Is scheme a match: " + resp.isSchemeMatches());

Ausgabe:

    Is URI a match: true
    Is scheme a match: true


