Skip to content

Instantly share code, notes, and snippets.

@joshuaebowling
Last active September 7, 2015 02:33
Show Gist options
  • Save joshuaebowling/98457ba11d743e146def to your computer and use it in GitHub Desktop.
Save joshuaebowling/98457ba11d743e146def to your computer and use it in GitHub Desktop.
Response to _Opportunity
// I'm going to leave my debugging code in so you can see how I prove to myself that I've resolved issues
/* I added the NAMESPACE declaration to troubleshoot.
* I understand this was only part of a larger
* codeblock that may or may not have declared NAMESPACE
*/
var NAMESPACE;
if (!NAMESPACE || typeof NAMESPACE == 'undefined') {
NAMESPACE = {
_all_ids: new Object()
};
var id = function (id) {
var persona = {};
// shorthand reference
var _all_ids = NAMESPACE._all_ids;
// local var declaration
var _id = id;
/* because the id gets deleted from _all_ids on close() invocation, I imagine it should be added also.
* but I have no clue to what end numbers are added or deleted from this array.
*/
// added terminating semi-colon to end of function
var getId = function () {
// use of local var
return _id;
};
// assignment of function to returned object
persona.getId = getId;
// add the current _id to _all_ids
_all_ids[_id] = persona;
// local var declaration
var _closed = false;
// added terminating semi-colon to end of function
var close = function () {
delete _all_ids[getId()];
// the line below references a prototypal property that doesn't seem to be in existence
// this._closed = true;
// the output below should prove that this._closed is an improper reference
console.log('according to the original code, this should be false, not undefined.', this._closed);
// instead, I'll reference the local property created above
_closed = true;
};
persona.close = close;
return persona;
}
NAMESPACE['id'] = id;
}
@joshuaebowling
Copy link
Author

@posita
First, thanks for the hints, I'll make good use of them below.

  1. With shamelessness and a grain of grit, I can show you a revision history.
  2. The id function is supposed to provide a means (via close) to remove ids from an Array manifesting itself as an instance named _all_ids, and separately return the id value (via getId) given when NAMESPACE.id was invoked with said value. It could function properly if the Array prototype is/was populated with or has access to a set of ids from which the class instance need only remove said id from _all_ids's prototype or Array's prototype.
  3. Taking your hint, I'd need to write unit tests. Specifically, I would need a suite that did the following:
  • push some values into Array's prototype
  • create an instance of Array via constructor then check if the value's pushed to Array's prototype are present in the instance as well.
  • create an instance of NAMESPACE.id passing a value pushed to Array's prototype as my id argument. Then, verify getId returns proper value. Then, invoke close. Then, check the indexOf said value to if it's less than 0. But, the test will prove my solution be invalid if I'm correct about the use Array's prototype as the populating mechanism. For my solution to be valid, I'd have to delete _all_ids.__proto__[getId()]; OR delete Array.prototype[getId()].

Then, another question occurs: what does it mean to close where close removes the id from the set? That could also mean that _id should also be set to undefined and perhaps even delete persona.
I will edit id.js accordingly if you would like.

Here are my test mock-ups

They assume NAMESPACE to be available for testing

@posita
Copy link

posita commented Sep 1, 2015

It could function properly if the Array prototype is/was populated with or has access to a set of _id_s from which the class instance need only remove said id from _all_ids's prototype or Array's prototype.

Ah, now we're getting warmer. Are you sure we want to go about modifying Array's prototype? After all, the original author went through the trouble to give us a NAMESPACE object, I'm assuming so id wouldn't create create clashes in the global name space. That seems to be a respectful practice. With that in mind, is modifying the prototype of a builtin type in order to get id "working" indicative of a deficiency with the builtin type or a problem with id?

You're right to point out that in the original code, nothing gets added to _all_ids, so delete'ing them doesn't really do anything. Is that indicative that something is missing? Is _all_ids even in the right place? Should it even be an Array instance, or should it be something else?

What if I told you that NAMESPACE.id was a constructor-ish thing for creating objects to be used in a server context, rather than a browser context? What if I also told you that ids were for modeling (keeping track of) some kind of server side resource? Does that help you guess what _all_ids was intended for? Does it help you guess what close should do?

One more hint: we can benefit a lot more from using the tools available to us. For example, consider making a full-fledged GitHub repository where you can track your code changes, check in unit tests, put how to run them in the README, etc. 😉

@joshuaebowling
Copy link
Author

@posita,
Personally, I don't know of any cases where it's prudent to alter the prototype in this way, especially a built-in one. That doesn't mean I've never seen it done or put it past a puzzler. But since this is not the scenario, I can happily move on.
I'm going to attempt this answer by straining my thoughts through your questions as follows:

Is that indicative that something is missing?

Yes, the addition of any data to _all_ids which acts as container of some sort.

Is _all_ids even in the right place?

I would have to say no since I've ruled out the possiblity of prototypal shenanigans. It would lead me to believe that it should be part of the NAMESPACE object. This possibility may be further confirmed by the name _all_ids since its formatted in an internal-ish style.

Should it even be an Array instance, or should it be something else?

It would make sense for it to be an Object, espeically since whatever is stored in _all_ids can be referenced like _all_ids[getId()] and whatever is referenced can be removed by delete _all_ids[getId] without creating undefined entries which happens when _all_ids is an instance of Array. Additionally, it would be non-standard (so far as I know) to remove items from an Array in this manner.
I'll demonstrate an Object-based solution in my edits to id.js.

What if I told you that NAMESPACE.id was a constructor-ish thing for creating objects to be used in a server context, rather than a browser context?

It would tell me that I don't need to be concerned with a clever user gaining access to other users' information or other malfeasances.

What if I also told you that ids were for modeling (keeping track of) some kind of server side resource?

Like a list of users for messaging or somesuch activity, which would explain close perhaps.

Does that help you guess what _all_ids was intended for?

For keeping track of ids that are yet to be closed. So an instance generated by id can be found and then deleted after a message/result is delivered/returned.

I rewrote the test mock-ups also

@posita
Copy link

posita commented Sep 2, 2015

I would have to say no since I've ruled out the possiblity of prototypal shenanigans. It would lead me to believe that it should be part of the NAMESPACE object. This possibility may be further confirmed by the name _all_ids since its formatted in an internal-ish style.

Excellent, so how can we fix it? Is it as simple as NAMESPACE._all_ids = {}, or should we do something else? What are the benefits/drawbacks to such an approach (vs. another)?

Like a list of users for messaging or somesuch activity, which would explain close perhaps.

Great examples.

For keeping track of ids that are yet to be closed. So an instance generated by id can be found and then deleted after a message/result is delivered/returned.

Let's write some tests that demonstrates how we expect close to work, then get those tests to pass (which probably implies fixing where _all_ids lives and how it's used).

We're getting there! 😁

I would recommend migrating this to a GitHub repository, since it provides better tools for this kind of thing. (At the very least, we'll know that @-style mentions notify the mentioned party).

@joshuaebowling
Copy link
Author

@posita,
I'll begin immediately.

@joshuaebowling
Copy link
Author

@posita,
see the repository

@joshuaebowling
Copy link
Author

@posita,
Is it as simple as NAMESPACE._all_ids = {}, or should we do something else? What are the benefits/drawbacks to such an approach (vs. another)?
Pros

  1. Simple is awesome, unless it's overly simplistic. What's more, it seems to work judging by the tests I've included in the repository.

Cons

  1. There's no protection from _all_ids getting overwritten or deleted accidentally.
  2. There would be no event hooks, etc.
  3. There would be no facility for features such as undo.

My recommendation: There is precedent in the code to declare a local and return the local from a function, a la var getId = function() {}; persona.getId = getId;
This will take care of Cons 1 which is critical while Cons 2,3 are pre-optimizey and I've seen no indication such features are necessary so far.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment