{"title":"Debugger.BreakOnError(Boolean) Method","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/methods-auto/debugger/debugger-breakonerror-method/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/methods-auto/debugger/debugger-breakonerror-method, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/methods-auto/debugger/debugger-breakonerror-method","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Sets whether the debugger breaks on errors.","date":"2026-10-01","meta":{"topic":"reference"},"outline":[{"level":1,"title":"Debugger.BreakOnError(Boolean) Method","slug":"debuggerbreakonerrorboolean-method","at":0,"chars":1321},{"level":2,"title":"Syntax","slug":"syntax","at":186,"chars":65},{"level":2,"title":"Parameters","slug":"parameters","at":251,"chars":101},{"level":2,"title":"Return Value","slug":"return-value","at":352,"chars":415},{"level":2,"title":"Remarks","slug":"remarks","at":767,"chars":92},{"level":2,"title":"Example","slug":"example","at":859,"chars":326},{"level":2,"title":"Related information","slug":"related-information","at":1185,"chars":136}],"text":"# Debugger.BreakOnError(Boolean) Method\n> Version: _Available or changed with runtime version 1.0 until version 4.0 where it was deprecated._\nSets whether the debugger breaks on errors.\n## Syntax\n```al\n[Ok := ]  Debugger.BreakOnError(Ok: Boolean)\n```\n## Parameters\nOk\nType: ../boolean/boolean-data-type\nSpecifies whether the debugger breaks on errors.\n## Return Value\n*[Optional] Ok*\nType: ../boolean/boolean-data-type\ntrue if the operation was successful; otherwise false. If you omit this optional return value and the operation does not execute successfully, a runtime error will occur.\nIf you omit this optional return value and if the break is not set successfully, then a run-time error occurs. If you include the return value, then you must handle any errors.\n## Remarks\nThe debugger must be attached to a session when you run the BreakOnError method.\n## Example\nThis example shows how to implement the code for an action on a page that sets the break on error setting to true. You can use this code example in the OnAction trigger of that action. This code example requires that you create a Boolean variable named Value.\n```al\nValue := true;\nDebugger.BreakOnError(Value);\n```\n## Related information\ndebugger-data-type\nGet Started with AL<../../devenv-get-started>\nDeveloping Extensions<../../devenv-dev-overview>"}