---
sourceDocument: オーストラリア API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference

 Release :

    - australia

ft:locale :

    - ja-JP

ft:publication_title :

    - オーストラリア API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# UriMatcher :スコープ対象

# UriMatcher :スコープ対象 {#ariaid-title1}

* リリースバージョン: Australia
* 
* 更新日 2026年03月12日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：4分

URI が、スキーム、ホスト、パス、フラグメント、およびクエリパラメーターの存在に関して指定された基準と一致するかどうかを確認するメソッドを提供します。

UriMatcher API には、デフォルトでアクティブになっている REST API プロバイダー (com.glide.rest) プラグインが必要です。

この API は、 `sn_ws` 名前空間内で提供されます。

## UriMatcher:UriMatcher() {#ariaid-title2}

新しい UriMatcher オブジェクトをインスタンス化します。
{#UriMatcher-UriMatcher__table_tq3_2pw_qdc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 1. パラメーター]

{#UriMatcher-UriMatcher__table_tq3_2pw_qdc}  
UriMatcher オブジェクトをインスタンス化します。

    var matcher = new sn_ws.UriMatcher();

## UriMatcher - match(文字列 uri, 文字列スキーム, アレイホスト, アレイパス, アレイフラグメント, ブール値 disallowQueryParameters) {#ariaid-title3}

URI が、スキーム、ホスト、パス、フラグメント、およびクエリパラメーターの存在に関して指定された基準と一致するかどうかを確認します。
{#UriMatcher-match_S_S_O_O_O_B__table_ejx_wjw_qdc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| uri | 文字列 | 指定された基準に対してテストする URI。 |
| スキーム | 文字列 | URI で使用されるプロトコル。 有効な値： * http * https {#UriMatcher-match_S_S_O_O_O_B__ul_c1s_24d_rdc} |
| ホスト | アレイ | URI 内の許可されたホストのリスト。 一致と見なされるには、URI で許可されたホストの 1 つを使用する必要があります。 |
| パス | アレイ | オプション。URI で許可されるパスのリスト。 一致と見なされるには、URI で許可されたパスの 1 つを使用する必要があり、許可されたパスは URI で使用される完全パスである必要があります。たとえば、許可されたパスが `/path1` の場合、パスが `/path1/more` の URI は一致とは見なされません。 注: パスは `/` で始まる必要があります。 デフォルト:任意のパスが許可されます。 |
| フラグメント | アレイ | オプション。URI で許可されるフラグメントのリスト。 URI は、許可されたフラグメントのいずれも含まれていない場合でも、一致と見なされます。URI は、許可リストにないフラグメントが含まれている場合にのみ、一致しないと見なされます。 デフォルト:任意のフラグメントが許可されます。 |
| disallowQueryParameters | ブーリアン | オプション。クエリパラメーターを URI で許可するかどうかを示すフラグ。 有効な値： * true:クエリパラメーターは使用できません。クエリパラメーターが URI に含まれている場合は、エラーが発生します。 * false:クエリパラメーターは許可されます。 {#UriMatcher-match_S_S_O_O_O_B__ul_qj4_k4d_rdc} デフォルト値：false |
[表 : 2. パラメーター]

{#UriMatcher-match_S_S_O_O_O_B__table_ejx_wjw_qdc} {#UriMatcher-match_S_S_O_O_O_B__table_fjx_wjw_qdc__entry__2}

| タイプ | 説明 |
|-|-|
| [UriMatcherResponse](https://servicenow-prod.fluidtopics.net/ffl4F7~T5eR8JFDEp88CLg#UriMatcherResponseScopedAPI "URI が、スキーム、ホスト、パス、フラグメント、およびクエリパラメーターの存在に関して指定された基準と一致するかどうかに関する情報を返すメソッドを提供します。") | 一致に関する詳細情報を返すメソッドを持つ UriMatcherResponse オブジェクト。 |
[表 : 3. 返される内容]

{#UriMatcher-match_S_S_O_O_O_B__table_fjx_wjw_qdc}  
この例では、URI が指定されたスキームとホストと一致するかどうかを確認します。

    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());

出力：

    Is URI a match: true

この例では、URI が指定されたスキーム、ホスト、パス、フラグメント、およびクエリパラメーターの存在と一致するかどうかを確認します。

    var uri = "https://example.com/path1/more";
    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("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());  
    gs.info("Error message: " + resp.getErrorMessages());

出力：

    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
    Error message: