Skip to content

docs(NODE-6516): add documentation for MongoOperationTimeoutError and fix internal references #4315

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

Merged
merged 3 commits into from
Nov 6, 2024

Conversation

nbbeeken
Copy link
Contributor

@nbbeeken nbbeeken commented Nov 5, 2024

Description

What is changing?

  • docs for MongoOperationTimeoutError
Is there new documentation needed for these changes?

What is the motivation for this change?

Clarity on the error subject

Double check the following

  • Ran npm run check:lint script
  • Self-review completed using the steps outlined here
  • PR title follows the correct format: type(NODE-xxxx)[!]: description
    • Example: feat(NODE-1234)!: rewriting everything in coffeescript
  • Changes are covered by tests
  • New TODOs have a related JIRA ticket

@@ -111,7 +111,9 @@ This class should **never** be directly instantiated.

### `MongoOperationTimeoutError`

- TODO(NODE-6491): Add MongoOperationTimeoutError documentation
The `MongoOperationTimeoutError` class represents an error that occurs when an operation could not be completed within the specified `timeoutMS`.
It is generated by the driver in support of the "client side operation timeout" feature so inherits from `MongoDriverError`.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
It is generated by the driver in support of the "client side operation timeout" feature so inherits from `MongoDriverError`.
It is generated by the driver in support of the "client side operation timeout" feature and inherits from `MongoDriverError`.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

fixed

- TODO(NODE-6491): Add MongoOperationTimeoutError documentation
The `MongoOperationTimeoutError` class represents an error that occurs when an operation could not be completed within the specified `timeoutMS`.
It is generated by the driver in support of the "client side operation timeout" feature so inherits from `MongoDriverError`.
When `timeoutMS` is enabled `MongoServerErrors` relating to `MaxTimeExpired` errors will be converted to `MongoOperationTimeoutError`
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
When `timeoutMS` is enabled `MongoServerErrors` relating to `MaxTimeExpired` errors will be converted to `MongoOperationTimeoutError`
When `timeoutMS` is enabled `MongoServerErrors` relating to `MaxTimeExpired` errors will be converted to `MongoOperationTimeoutError`.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

fixed

@@ -28,7 +28,6 @@ import {
import { type FailPoint, makeMultiBatchWrite, measureDuration } from '../../tools/utils';
import { filterForCommands } from '../shared';

// TODO(NODE-5824): Implement CSOT prose tests
Copy link
Contributor

Choose a reason for hiding this comment

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

There is a comment that says
'TODO(DRIVERS-2965): see modified test in unified-csot-node-specs', // Skipping for both tailable awaitData and tailable non-awaitData cursors
in client_side_operations_timeout.spec.test.ts - can we remove or update it in this PR?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

removed

@dariakp dariakp changed the title docs(NODE-6516): add documentation for MongoOperationTimeoutError docs(NODE-6516): add documentation for MongoOperationTimeoutError and fix internal references Nov 5, 2024
@nbbeeken nbbeeken marked this pull request as ready for review November 6, 2024 14:33
@nbbeeken nbbeeken added the Primary Review In Review with primary reviewer, not yet ready for team's eyes label Nov 6, 2024
@dariakp dariakp merged commit 5d497c5 into NODE-6090 Nov 6, 2024
3 of 4 checks passed
@dariakp dariakp deleted the NODE-6516-doc-error branch November 6, 2024 14:46
dariakp pushed a commit that referenced this pull request Nov 6, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Primary Review In Review with primary reviewer, not yet ready for team's eyes
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants