Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[DI] Switch unit tests to Mocha instead of Tap #4728

Merged
merged 3 commits into from
Oct 2, 2024
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions integration-tests/debugger/index.spec.js
Original file line number Diff line number Diff line change
Expand Up @@ -308,6 +308,22 @@ describe('Dynamic Instrumentation', function () {
assert.isTrue(payload['debugger.snapshot'].timestamp > Date.now() - 1000 * 60)
assert.isTrue(payload['debugger.snapshot'].timestamp <= Date.now())

assert.isArray(payload['debugger.snapshot'].stack)
assert.isAbove(payload['debugger.snapshot'].stack.length, 0)
for (const frame of payload['debugger.snapshot'].stack) {
assert.isObject(frame)
assert.hasAllKeys(frame, ['fileName', 'function', 'lineNumber', 'columnNumber'])
assert.isString(frame.fileName)
assert.isString(frame.function)
assert.isAbove(frame.lineNumber, 0)
assert.isAbove(frame.columnNumber, 0)
}
const topFrame = payload['debugger.snapshot'].stack[0]
assert.match(topFrame.fileName, new RegExp(`${appFile}$`)) // path seems to be prefeixed with `/private` on Mac
assert.strictEqual(topFrame.function, 'handler')
assert.strictEqual(topFrame.lineNumber, probeLineNo)
assert.strictEqual(topFrame.columnNumber, 3)

done()
})

Expand Down
4 changes: 2 additions & 2 deletions package.json
Original file line number Diff line number Diff line change
Expand Up @@ -20,8 +20,8 @@
"test:appsec:ci": "nyc --no-clean --include \"packages/dd-trace/src/appsec/**/*.js\" --exclude \"packages/dd-trace/test/appsec/**/*.plugin.spec.js\" -- npm run test:appsec",
"test:appsec:plugins": "mocha -r \"packages/dd-trace/test/setup/mocha.js\" \"packages/dd-trace/test/appsec/**/*.@($(echo $PLUGINS)).plugin.spec.js\"",
"test:appsec:plugins:ci": "yarn services && nyc --no-clean --include \"packages/dd-trace/src/appsec/**/*.js\" -- npm run test:appsec:plugins",
"test:debugger": "tap packages/dd-trace/test/debugger/**/*.spec.js",
"test:debugger:ci": "npm run test:debugger -- --coverage --nyc-arg=--include=\"packages/dd-trace/src/debugger/**/*.js\"",
"test:debugger": "mocha -r 'packages/dd-trace/test/setup/mocha.js' 'packages/dd-trace/test/debugger/**/*.spec.js'",
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

(absolute nit) unrelated to this PR: using :debugger is a bit confusing to me given that debugger is a keyword and that I usually use test:debug to pass --inspect-brk to test sessions.

Maybe test:dynamic-inst ? That's awful 😆 , so feel free to disregard

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would have preferred to use something related to our product name as well, but it's called "debugger" in all the other languages for historical reasons, so I was told to use this name in Node.js as well. I'll ask around to see if we still think this is a good idea. But if we decide to rename it, I'll make a separate PR as it touches a lot of other areas of the code as well - not just these lines.

"test:debugger:ci": "nyc --no-clean --include 'packages/dd-trace/src/debugger/**/*.js' -- npm run test:debugger",
"test:trace:core": "tap packages/dd-trace/test/*.spec.js \"packages/dd-trace/test/{ci-visibility,datastreams,encode,exporters,opentelemetry,opentracing,plugins,service-naming,telemetry}/**/*.spec.js\"",
"test:trace:core:ci": "npm run test:trace:core -- --coverage --nyc-arg=--include=\"packages/dd-trace/src/**/*.js\"",
"test:instrumentations": "mocha -r 'packages/dd-trace/test/setup/mocha.js' 'packages/datadog-instrumentations/test/**/*.spec.js'",
Expand Down
13 changes: 13 additions & 0 deletions packages/dd-trace/src/debugger/devtools_client/index.js
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ const { randomUUID } = require('crypto')
const { breakpoints } = require('./state')
const session = require('./session')
const send = require('./send')
const { getScriptUrlFromId } = require('./state')
const { ackEmitting } = require('./status')
const { parentThreadId } = require('./config')
const log = require('../../log')
Expand Down Expand Up @@ -35,6 +36,17 @@ session.on('Debugger.paused', async ({ params }) => {
thread_name: threadName
}

const stack = params.callFrames.map((frame) => {
let fileName = getScriptUrlFromId(frame.location.scriptId)
if (fileName.startsWith('file://')) fileName = fileName.substr(7) // TODO: This might not be required
return {
fileName,
function: frame.functionName,
lineNumber: frame.location.lineNumber + 1, // Beware! lineNumber is zero-indexed
columnNumber: frame.location.columnNumber + 1 // Beware! columnNumber is zero-indexed
}
})

// TODO: Send multiple probes in one HTTP request as an array
for (const probe of probes) {
const snapshot = {
Expand All @@ -45,6 +57,7 @@ session.on('Debugger.paused', async ({ params }) => {
version: probe.version,
location: probe.location
},
stack,
language: 'javascript'
}

Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
'use strict'

const { workerData: { rcPort } } = require('node:worker_threads')
const { getScript, probes, breakpoints } = require('./state')
const { findScriptFromPartialPath, probes, breakpoints } = require('./state')
const session = require('./session')
const { ackReceived, ackInstalled, ackError } = require('./status')
const log = require('../../log')
Expand Down Expand Up @@ -120,7 +120,7 @@ async function addBreakpoint (probe) {
// TODO: Inbetween `await session.post('Debugger.enable')` and here, the scripts are parsed and cached.
// Maybe there's a race condition here or maybe we're guraenteed that `await session.post('Debugger.enable')` will
// not continue untill all scripts have been parsed?
const script = getScript(file)
const script = findScriptFromPartialPath(file)
if (!script) throw new Error(`No loaded script found for ${file} (probe: ${probe.id}, version: ${probe.version})`)
const [path, scriptId] = script

Expand Down
14 changes: 10 additions & 4 deletions packages/dd-trace/src/debugger/devtools_client/state.js
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,8 @@

const session = require('./session')

const scripts = []
const scriptIds = []
const scriptUrls = new Map()

module.exports = {
probes: new Map(),
Expand All @@ -25,10 +26,14 @@ module.exports = {
* @param {string} path
* @returns {[string, string] | undefined}
*/
getScript (path) {
return scripts
findScriptFromPartialPath (path) {
return scriptIds
.filter(([url]) => url.endsWith(path))
.sort(([a], [b]) => a.length - b.length)[0]
},

getScriptUrlFromId (id) {
return scriptUrls.get(id)
}
}

Expand All @@ -41,7 +46,8 @@ module.exports = {
// - `` - Not sure what this is, but should just be ignored
// TODO: Event fired for all files, every time debugger is enabled. So when we disable it, we need to reset the state
session.on('Debugger.scriptParsed', ({ params }) => {
scriptUrls.set(params.scriptId, params.url)
if (params.url.startsWith('file:')) {
scripts.push([params.url, params.scriptId])
scriptIds.push([params.url, params.scriptId])
}
})
16 changes: 8 additions & 8 deletions packages/dd-trace/test/debugger/devtools_client/status.spec.js
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
'use strict'

require('../../setup/tap')
require('../../setup/mocha')

const ddsource = 'dd_debugger'
const service = 'my-service'
const runtimeId = 'my-runtime-id'

describe('diagnostic message http request caching', () => {
describe('diagnostic message http request caching', function () {
let statusproxy, request

const acks = [
Expand All @@ -16,7 +16,7 @@ describe('diagnostic message http request caching', () => {
['ackError', 'ERROR', new Error('boom')]
]

beforeEach(() => {
beforeEach(function () {
request = sinon.spy()
request['@noCallThru'] = true

Expand All @@ -27,10 +27,10 @@ describe('diagnostic message http request caching', () => {
})

for (const [ackFnName, status, err] of acks) {
describe(ackFnName, () => {
describe(ackFnName, function () {
let ackFn, exception

beforeEach(() => {
beforeEach(function () {
if (err) {
ackFn = statusproxy[ackFnName].bind(null, err)
// Use `JSON.stringify` to remove any fields that are `undefined`
Expand All @@ -45,7 +45,7 @@ describe('diagnostic message http request caching', () => {
}
})

it('should only call once if no change', () => {
it('should only call once if no change', function () {
ackFn({ id: 'foo', version: 0 })
expect(request).to.have.been.calledOnce
assertRequestData(request, { probeId: 'foo', version: 0, status, exception })
Expand All @@ -54,7 +54,7 @@ describe('diagnostic message http request caching', () => {
expect(request).to.have.been.calledOnce
})

it('should call again if version changes', () => {
it('should call again if version changes', function () {
ackFn({ id: 'foo', version: 0 })
expect(request).to.have.been.calledOnce
assertRequestData(request, { probeId: 'foo', version: 0, status, exception })
Expand All @@ -64,7 +64,7 @@ describe('diagnostic message http request caching', () => {
assertRequestData(request, { probeId: 'foo', version: 1, status, exception })
})

it('should call again if probeId changes', () => {
it('should call again if probeId changes', function () {
ackFn({ id: 'foo', version: 0 })
expect(request).to.have.been.calledOnce
assertRequestData(request, { probeId: 'foo', version: 0, status, exception })
Expand Down
Loading