(info) This AI is still in early stages of development.

Diag.run()

Owned by Aubergine
Last updated: Nov 11, 2012Version comment
1 min read
Run a diagnostic.

 

Syntax

var result = Diag.run(name, params); // run a diagnostic

Parameters

ParameterTypeMandatoryNotesDiag Ver
nameString(tick)

Name of the diagnostic routine.

(warning) Must not contain any spaces! Will always be converted to lowercase.

1.0
paramsVariant(error)

Any additional parameters to pass in to the routine.

(warning) Note that if using the in-game chat interface they will all be stings.

1.0

Return values

ValueTypeNotesDiag Ver
<string>StringThe results of the diagnostic in a single string.1.0
<array>Array of StringThe results of the diagnostic in an array of strings (or values that will reliably typecast to strings).1.0
<error>String

If something goes wrong, the error message will be returned as a string.

1.0

Example

Echo parameters back to calling script
// define a diagnostic routine function
var myDiagFn = function bar(name, param1, param2, etc) {
  // name always converted to lowercase
  // return arguments object converted in to an array
  return Array.prototype.splice.call(arguments);
}
 
Diag.add("foo", myDiagFn); // register myDiagFn under the name "foo"

Diag("Foo", true, "bleh"); // ["foo", true, "bleh"]

Notes

See Diag.add() for notes about diagnostic routine functions.

Availability BETA

Requires:

  • Warzone 3.1 or above
  • Warzone 3.2 or above (for chat interface)
  • Diag API
Contents

Jump to:

Diag API

Topics:

  • Diag() — Run a diagnostic routine...
  • Diag API Diagnostics — The Diag API provides a few diagnostic routines of it's own...
  • Lazy Loading Diagnostics — By lazy loading diagnostic routines, your script will start faster and use less RAM if diagnostics are not required.