FANDOM


Consoledebug

The debug console is a Scribunto tool that allows one to quickly try out some code in real time. It is only available when editing a module in the Module:Namespace as show in the screenshot.

The debug console is designed for testing pure Lua logic (tables, methods & primitives). Thus, it has a couple limitations in Scribunto:

  • Frame object isn't available.
  • Lua variables can't be inspected or displayed in human-readable format.

See #Limitations for some workarounds.

Purpose

This helps to debug one or more modules without having to leave the current page and without having to save a page. A good introduction for Lua is available in Wikiversity[1].

Usage

There are primarily two ways to interact with the debug console. One by directly typing text and waiting for the output, and the other is to access functions in the code editor.

Direct

Debugusage

The simplest way to use the code editor is to write code directly in it and pressing "enter". The results may take some time because they are returned from the server.

Example

 print (5 * 6)
Output:
30

Code editor

ConsoleDemo1
One can quickly put code in the code editor and try it out using the console before saving as depicted in the image. This helps to try out a lot of code without filling up the debug console, and it reduces the need to copy paste from console to editor.
--Code Editor 
local p = {}
 
function p.morning()
   return "Good morning to you too"
end
 
return  p
--Console
print(p.morning())

Other functions from external modules

Trying other functions from modules stored in other pages is also possible. This is possible using:

--Module:Morning
local p = {}
 
function p.morning()
   return "Good morning to you too"
end
--Console
local storedModule = require("Module:Morning")
print(storedModule.morning())
Output: 
Good morning to you too

Global Modules

Modules stored in a central repository (dev.wikia.com) can also be accessed in a similar manner to external modules by writing:

local storedModule = require("Dev:Morning")
print(storedModule.morning())

Limitations

  1. Frame object unavailable.
    • Functions that use the frame can't be easily tested using the console.
    • It may show errors when a regular invoke wouldn't especially if they use things such as frame:preprocess() or frame:getCurrentTitle().
    • One way around this is to create a fake frame such as the one used in Module:Debug to test out the functions.
  2. Object inspection unavailable.
    • The console is very static. It can't visually inspect first-class items (primitives & functions), tables, & their metatables.
    • The Inspect metamodule can help get around this, by rendering Lua items in a human-readable format.

Tips and tricks

Rather than writing the whole text each time or pasting it into the console, one can add commonly used functions or code to MediaWiki:Scribunto-console-intro. This will allow anyone in the community easy access to them.

See also

References

  1. https://en.wikiversity.org/wiki/Lua
Community content is available under CC-BY-SA unless otherwise noted.

Fandom may earn an affiliate commission on sales made from links on this page.

Stream the best stories.

Fandom may earn an affiliate commission on sales made from links on this page.

Get Disney+