GeezerVison is showing github.com — doc, tls: mark parseCertString() as deprecated · nodejs/node@b09eeb4
File tree
Expand file treeCollapse file tree
Open diff view settings
Expand file treeCollapse file tree
Open diff view settings
Collapse file
Copy file name to clipboardExpand all lines: doc/api/deprecations.md +23Lines changed: 23 additions & 0 deletions - Display the source diff
- Display the rich diff
| Original file line number | Diff line number | Diff line change |
|---|
@@ -630,6 +630,29 @@ Type: Runtime |
630 | 630 |
|
631 | 631 | *Note*: change was made while `async_hooks` was an experimental API. |
632 | 632 |
|
| 633 | +<a id="DEP0076"></a> |
| 634 | +### DEP0076: tls.parseCertString() |
| 635 | + |
| 636 | +Type: Documentation-only |
| 637 | + |
| 638 | +`tls.parseCertString()` is a trivial parsing helper that was made public by |
| 639 | +mistake. This function can usually be replaced with: |
| 640 | + |
| 641 | +```js |
| 642 | +const querystring = require('querystring'); |
| 643 | +querystring.parse(str, '\n', '='); |
| 644 | +``` |
| 645 | + |
| 646 | +*Note*: This function is not completely equivalent to `querystring.parse()`. One |
| 647 | +difference is that `querystring.parse()` does url encoding: |
| 648 | + |
| 649 | +```sh |
| 650 | +> querystring.parse('%E5%A5%BD=1', '\n', '='); |
| 651 | +{ '好': '1' } |
| 652 | +> tls.parseCertString('%E5%A5%BD=1'); |
| 653 | +{ '%E5%A5%BD': '1' } |
| 654 | +``` |
| 655 | +
|
633 | 656 | [`Buffer.allocUnsafeSlow(size)`]: buffer.html#buffer_class_method_buffer_allocunsafeslow_size |
634 | 657 | [`Buffer.from(array)`]: buffer.html#buffer_class_method_buffer_from_array |
635 | 658 | [`Buffer.from(buffer)`]: buffer.html#buffer_class_method_buffer_from_buffer |
|