/** Provides a class for working with defect query results stored in dashboard databases. */

import semmle.javascript.Files

/**

* Holds if `id` in the opaque identifier of a result reported by query `queryPath`,

* such that `message` is the associated message and the location of the result spans

* column `startcol` of line `startline` to column `endcol` of line `endline`

* in `file`.

*

* For more information, see [Locations](https://codeql.github.com/docs/writing-codeql-queries/providing-locations-in-codeql-queries/).

*/

external predicate defectResults(

int id, string queryPath, string file, int startline, int startcol, int endline, int endcol,

string message

);

/**

* A defect query result stored in a dashboard database.

*/

class DefectResult extends int {

DefectResult() { defectResults(this, _, _, _, _, _, _, _) }

/** Gets the path of the query that reported the result. */

string getQueryPath() { defectResults(this, result, _, _, _, _, _, _) }

/** Gets the file in which this query result was reported. */

File getFile() {

exists(string path | defectResults(this, _, path, _, _, _, _, _) |

result.getAbsolutePath() = path

)

}

/** Gets the line on which the location of this query result starts. */

int getStartLine() { defectResults(this, _, _, result, _, _, _, _) }

/** Gets the column on which the location of this query result starts. */

int getStartColumn() { defectResults(this, _, _, _, result, _, _, _) }

/** Gets the line on which the location of this query result ends. */

int getEndLine() { defectResults(this, _, _, _, _, result, _, _) }

/** Gets the column on which the location of this query result ends. */

int getEndColumn() { defectResults(this, _, _, _, _, _, result, _) }

/** Gets the message associated with this query result. */

string getMessage() { defectResults(this, _, _, _, _, _, _, result) }

/** Gets the URL corresponding to the location of this query result. */

string getURL() {

result =

"file://" + this.getFile().getAbsolutePath() + ":" + this.getStartLine() + ":" +

this.getStartColumn() + ":" + this.getEndLine() + ":" + this.getEndColumn()

}

}