ruthst00 opened a new pull request, #6772: URL: https://github.com/apache/jmeter/pull/6772
…x Extractor, Boundary Extractor, etc.) had no documentation explaining that leaving it blank is equivalent to `0` (random match), causing user confusion. ## Description <!--- Provide a general summary of your changes in the Title above --> <!--- Describe your changes in detail here --> __Changes made:__ __`xdocs/usermanual/component_reference.xml`__ — Updated the documentation for the *Match No.* field in the Regex Extractor, Boundary Extractor, CSS/JQuery Extractor, XPath2 Extractor, XPath Extractor, JSON Extractor, and JMES Path Extractor sections to explicitly state: *"If left blank or set to 0, a random match is returned."* ## Motivation and Context <!--- Why is this change required? What problem does it solve? --> <!--- If it fixes an open issue, please link to the issue here. --> The issue was that the __Match No.__ field in extractor elements (Regex Extractor, Boundary Extractor, etc.) had no documentation explaining that leaving it blank is equivalent to `0` (random match), causing user confusion. Fixes [#6378](https://github.com/apache/jmeter/issues/6378) ## How Has This Been Tested? <!--- Please describe in detail how you tested your changes. --> <!--- Include details of your testing environment, tests ran to see how --> <!--- your change affects other areas of the code, etc. --> __`TestBoundaryExtractor.java`__ — Added three new tests: - `testMatchNumberZeroRandomSingleMatch` — verifies `matchNumber=0` returns the single available match - `testMatchNumberZeroRandomMultipleMatches` — verifies `matchNumber=0` returns one of the available matches - `testEmptyMatchNumberFieldBehavesLikeZero` — verifies an empty Match No. field behaves identically to `matchNumber=0` __`TestRegexExtractor.java`__ — Added one new test: - `testEmptyMatchNumberFieldBehavesLikeZero` — verifies an empty Match No. field behaves identically to `matchNumber=0` ## Screenshots (if appropriate): ## Types of changes <!--- What types of changes does your code introduce? Delete as appropriate --> - Bug fix (non-breaking change which fixes an issue) ## Checklist: <!--- Go over all the following points, and put an `x` in all the boxes that apply. --> <!--- If you're unsure about any of these, don't hesitate to ask. We're here to help! --> - [X] My code follows the [code style][style-guide] of this project. - [X] I have updated the documentation accordingly. Generated with [Claude Sonnet](https://www.anthropic.com/claude/sonnet) via [Cline API Provider](https://cline.bot/) -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
