Method: projects.test

string

ที่จำเป็น. สำหรับการทดสอบกับ source ชื่อทรัพยากรต้องอ้างอิงถึงโปรเจ็กต์: รูปแบบ: projects/{project_id}

{
  "testCases": [
    {
      object (TestCase)
    }
  ]
}

object ( TestCase )

การรวบรวมกรณีทดสอบที่เกี่ยวข้องกับ TestSuite

{
  "expectation": enum (Expectation),
  "request": value,
  "resource": value,
  "functionMocks": [
    {
      object (FunctionMock)
    }
  ],
  "pathEncoding": enum (PathEncoding),
  "expressionReportLevel": enum (ExpressionReportLevel)
}

enum ( Expectation )

ทดสอบความคาดหวัง

value ( Value format)

ขอบริบท

รูปแบบที่แน่นอนของบริบทคำขอขึ้นอยู่กับบริการ ดูเอกสารการบริการที่เหมาะสมสำหรับข้อมูลเกี่ยวกับฟิลด์และประเภทที่รองรับในคำขอ ขั้นต่ำสุดคือบริการทั้งหมดรองรับฟิลด์และประเภทต่อไปนี้:

หากค่าคำขอมีรูปแบบไม่ถูกต้องสำหรับบริการ คำขอจะถูกปฏิเสธเนื่องจากอาร์กิวเมนต์ที่ไม่ถูกต้อง

value ( Value format)

มูลค่าทรัพยากรเพิ่มเติมตามที่ปรากฏในที่เก็บข้อมูลถาวรก่อนที่จะตอบสนองคำขอ

ประเภททรัพยากรขึ้นอยู่กับค่า request.path

object ( FunctionMock )

ฟังก์ชันกฎเสริมจะจำลองสำหรับฟังก์ชันที่กำหนดโดยบริการ หากไม่ได้ตั้งค่า ฟังก์ชันกฎที่กำหนดโดยบริการใดๆ จะต้องส่งคืนข้อผิดพลาด ซึ่งอาจส่งผลต่อผลการทดสอบหรือไม่ก็ได้

enum ( PathEncoding )

ระบุว่าเส้นทาง (เช่น request.path) ได้รับการเข้ารหัสหรือไม่ และอย่างไร

enum ( ExpressionReportLevel )

ระบุสิ่งที่ควรรวมไว้ในการตอบกลับ

{
  "function": string,
  "args": [
    {
      object (Arg)
    }
  ],
  "result": {
    object (Result)
  }
}

string

ชื่อของฟังก์ชัน

ชื่อฟังก์ชันจะต้องตรงกับชื่อที่ระบุในการประกาศบริการ

object ( Arg )

รายการค่า Arg ที่จะจับคู่ ลำดับที่ให้อาร์กิวเมนต์คือลำดับที่ต้องปรากฏในการเรียกใช้ฟังก์ชัน

object ( Result )

ผลลัพธ์จำลองของการเรียกใช้ฟังก์ชัน

{

  // Union field type can be only one of the following:
  "exactValue": value,
  "anyValue": {
    object
  }
  // End of list of possible types for union field type.
}

value ( Value format)

อาร์กิวเมนต์ตรงกับค่าที่ระบุทุกประการ

object

อาร์กิวเมนต์ตรงกับค่าใดๆ ที่ให้ไว้

{

  // Union field type can be only one of the following:
  "value": value,
  "undefined": {
    object
  }
  // End of list of possible types for union field type.
}

value ( Value format)

ผลลัพธ์ที่ได้คือมูลค่าที่แท้จริง ประเภทของค่าจะต้องตรงกับประเภทที่บริการประกาศไว้

object

ผลลัพธ์ไม่ได้กำหนดไว้ หมายความว่าไม่สามารถคำนวณผลลัพธ์ได้

{
  "sourcePosition": {
    object (SourcePosition)
  },
  "description": string,
  "severity": enum (Severity)
}

object ( SourcePosition )

ตำแหน่งของปัญหาใน Source

string

คำอธิบายข้อผิดพลาดสั้น ๆ

enum ( Severity )

ความรุนแรงของปัญหา

{
  "fileName": string,
  "line": integer,
  "column": integer,
  "currentOffset": integer,
  "endOffset": integer
}

string

ชื่อของ File .

integer

หมายเลขบรรทัดของส่วนแหล่งที่มา 1-based

integer

คอลัมน์แรกบนบรรทัดต้นทางที่เกี่ยวข้องกับส่วนของต้นทาง

integer

ตำแหน่งเริ่มต้นสัมพันธ์กับจุดเริ่มต้นของไฟล์

integer

ตำแหน่งสิ้นสุดสัมพันธ์กับจุดเริ่มต้นของไฟล์

{
  "state": enum (State),
  "debugMessages": [
    string
  ],
  "errorPosition": {
    object (SourcePosition)
  },
  "functionCalls": [
    {
      object (FunctionCall)
    }
  ],
  "visitedExpressions": [
    {
      object (VisitedExpression)
    }
  ],
  "expressionReports": [
    {
      object (ExpressionReport)
    }
  ]
}

enum ( State )

สถานะของการทดสอบ

string

แก้ไขข้อความที่เกี่ยวข้องกับปัญหาการดำเนินการทดสอบที่พบในระหว่างการประเมิน

ข้อความแก้ไขข้อบกพร่องอาจเกี่ยวข้องกับการเรียกใช้ฟังก์ชันจำลองมากเกินไปหรือน้อยเกินไป หรือข้อผิดพลาดรันไทม์ที่เกิดขึ้นระหว่างการประเมิน

ตัวอย่างเช่น: Unable to read variable [name: "resource"]

object ( SourcePosition )

ตำแหน่งใน Source ที่มาที่เกิดข้อผิดพลาดรันไทม์หลัก

การประเมินนิพจน์อาจส่งผลให้เกิดข้อผิดพลาด กฎจะถูกปฏิเสธตามค่าเริ่มต้น ดังนั้นการคาดหวัง DENY เมื่อมีข้อผิดพลาดเกิดขึ้นจึงถือว่าถูกต้อง เมื่อมี DENY โดยมีข้อผิดพลาด SourcePosition จะถูกส่งกลับ

เช่น errorPosition { line: 19 column: 37 }

object ( FunctionCall )

ชุดของการเรียกใช้ฟังก์ชันที่ทำกับวิธีการที่กำหนดโดยบริการ

การเรียกใช้ฟังก์ชันจะรวมอยู่ในลำดับที่พบระหว่างการประเมิน มีไว้สำหรับฟังก์ชันที่จำลองและไม่ได้จำลอง และรวมไว้ในการตอบสนองโดยไม่คำนึงถึง state การทดสอบ

object ( VisitedExpression )

ชุดของนิพจน์สิทธิ์ที่เยี่ยมชมสำหรับการทดสอบที่กำหนด ซึ่งจะส่งคืนตำแหน่งและผลการประเมินของนิพจน์สิทธิ์ที่เยี่ยมชมทั้งหมดซึ่งเกี่ยวข้องกับกรณีทดสอบ เช่น

match /path {
  allow read if: <expr>
}

สำหรับรายงานโดยละเอียดเกี่ยวกับสถานะการประเมินระดับกลาง โปรดดูที่ฟิลด์ expressionReports

object ( ExpressionReport )

การแมปจากนิพจน์ในชุดกฎ AST กับค่าที่ได้รับการประเมิน ซ้อนกันบางส่วนเพื่อสะท้อนโครงสร้าง AST โปรดทราบว่าจริง ๆ แล้วฟิลด์นี้ติดตามนิพจน์และไม่ใช่คำชี้แจงสิทธิ์ซึ่งตรงกันข้ามกับฟิลด์ "visitedExpressions" ด้านบน สำนวนตามตัวอักษรจะถูกละเว้น

{
  "function": string,
  "args": [
    value
  ]
}

string

ชื่อของฟังก์ชันที่เรียกใช้

value ( Value format)

อาร์กิวเมนต์ที่กำหนดให้กับฟังก์ชัน

{
  "sourcePosition": {
    object (SourcePosition)
  },
  "value": value
}

object ( SourcePosition )

ตำแหน่งใน Source ซึ่งมีการเยี่ยมชมนิพจน์

value ( Value format)

ค่าที่ประเมินสำหรับนิพจน์ที่เข้าชม เช่น จริง/เท็จ

{
  "sourcePosition": {
    object (SourcePosition)
  },
  "values": [
    {
      object (ValueCount)
    }
  ],
  "children": [
    {
      object (ExpressionReport)
    }
  ]
}

object ( SourcePosition )

ตำแหน่งของนิพจน์ในแหล่งที่มาของกฎดั้งเดิม

object ( ValueCount )

ค่าที่นิพจน์นี้ประเมินเมื่อพบ

object ( ExpressionReport )

การแสดงออกย่อย

{
  "value": value,
  "count": integer
}

value ( Value format)

ค่าที่ส่งคืนของนิพจน์

integer

จำนวนครั้งที่นิพจน์นั้นส่งคืน